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NOTE: Although referenced in several areas, photographs are not 
shown in this document. Future revisions will include appro- 
priate photos and illustrated drawings. Your warranty registra- 
tion form must be returned promptly to assure receipt of future 
revisions to this document. 

This Class A equipment generates, uses, and can radiate radio frequency energy and if not installed and 
used in accordance with the instructions manual, may cause interference to radio communications. As 
temporarily permitted by regulation it has not been tested for compliance with the limits for Class A com- 
puting devices pursuant to Subpart I of Part 15 of FCC Rules, which are designed to provide reasonable 
protection against such interference. Operation of this equipment in a residential area is likely to cause in- 
terference in which case the user at his own expense will be required to take whatever measures may be 
required to correct the interference. 



CONFIDENTIAL 
AND 
PROPRIETARY INFORMATION 



Information presented in this manual is furnished for customer 
reference only and is subject to change. 

This document is the property of Intertec Data Systems 
Corporation, Columbia, South Carolina, and contains confidential 
and trade secret information. This information may not be trans- 
ferred from the custody or control of Intertec except as 
authorized by Intertec and then only by way of loan for limited 
purposes. It must not be reproduced in whole or in part and must 
be returned to Intertec upon request and in all events upon 
completion of the purpose of the loan. 

Neither this document nor the information it contains may be used 
or disclosed to persons not having a need for such use or 
disclosure consistent with the purpose of the loan without the 
prior express written consent of Intertec. 

COPYRIGHT 1981 

The following is a trademark of Intertec Data Systems 
Corporation, Columbia, South Carolina: 

COMPUSTAR 

INTERTEC DATA SYSTEMS CORPORATION 
Columbia, South Carolina 



CONGRATULATIONS ON YOUR PURCHASE OF INTERTEC'S COMPUSTAR 

VIDEO PROCESSING SYSTEM 



Your new CompuStar Video Processing System was manufactured at 
Intertec's 120,000 square foot plant in Columbia, South Carolina 
under stringent quality control procedures to insure trouble-free 
operation for many years. I£ you should encounter difficulties 
with the use or operation of your terminal , contact the dealer 
from whom the unit was purchased for instructions regarding the 
proper servicing techniques . If service cannot be made available 
through your dealer, contact Intertec's Customer Service 
Department at (803) 798-9100. 

As with all Intertec products, we would appreciate any comments 
you may have regarding your evaluation and application for this 
equipment. For your convenience, we have enclosed a customer 
comment card at the end of this manual. Please address your 
comments to: 

Marketing Services Manager 
Intertec Data Systems Corporation 
2300 Broad River Road 
Columbia, South Carolina 29210 

The CompuStar is distributed worldwide through a network of 
dealer/OEM vendors and through Intertec's own marketing 
facilities. Contact us at (803) 798-9100 (TWX - 810-666-2115) 
regarding your requirement for this and other Intertec products. 



WILL THE MICROCOMPUTER YOU BUY TODAY 
STILL BE THE BEST MICROCOMPUTER BUY TOMORROW? 



Probably the best test in determining how to spend your 
microcomputer dollar wisely is to consider the overall 
versatility of your terminal purchase over the next three to five 
years. In the fast-paced, ever-changing world of data 
communications, new features to increase operator and machine 
efficiency are introduced into the marketplace daily. We at 
Intertec are acutely aware of this rapid infusion of new ideas 
into the small systems business. As a result, we have designed 
the CompuStar in such a manner as to virtually eliminate the 
possibility of obsolescence. 

Many competitive alternatives to the CompuStar available today 
provide only limited capability for high level programming and 
system expansion. Indeed, most low-cost microcomputer systems 
presently available quickly become outdated because of the 
inability to expand the system. Intertec, however, realizes that 
increased demands for more efficient utilization of programming 
makes system expansion capability mandatory. That means a lot. 
Because the more you use your CompuStar, the more you'll discover 
its adaptability to virtually any small system requirement. 
Extensive use of "software-oriented" design concepts instead of 
conventional "hardware" designs assure you of compa tability with 
almost any application for which you intend to use the CompuStar. 

Once you read our operator's manual and try out some of the 
features described herein, we are confident that you too will 
agree with our "top performance--bottom dollar" approach to manu- 
facturing. The CompuStar offers you many more extremely flexible 
features at a lower cost than any other microcomputer we konw of 
on the market today. The use of newly developed technologies, 
efficient manufacturing processes and consumer-oriented 
marketing program enables us to be the first and only major 
manufacturer to offer such an incredible breakthrough in the 
microcomputer marketplace. 

Browse through our operator's manual and sit down in front of a 
CompuStar Video Processing Unit for a few hours. Then, let us 
know what you think about our new system. There is a customer 
comment card enclosed in the rear section of this manual for your 
convenience . 

Thank you for selecting the CompuStar as your choice for a micro- 
computer system. We hope you will be selecting it many more 
times in the future. 
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SECTION 1.0 

1.1 INTRODUCTION 

1 .2 SYSTEM UNPACKING 
INSTRUCTIONS 

1 .3 SYSTEM SETUP 
INSTRUCTIONS 




*** IMPORTANT *** 



Do not attempt to write or save programs on your system 
diskette(s). It has been 'write protected' by placing a small 
adhesive aluminum strip over the notch on the right hand side of 



the diskette. Such attempts will result in a 'WRITE' or 
SECTOR' error. 



BAD 



Before using your CompuStar, please copy the System Diskette onto 
a new blank diskette--an Intertec 1121010 diskette. If you do 
not have such a diskette, contact your local dealer. He should 
be able to supply you with one. If you have any questions 
concerning this procedure, please contact your dealer before pro- 
ceeding. Failure to do so may result in permanent damage to your 
System Diskette. 



BEFORE APPLYING POWER TO THE MACHINE, INSURE THAT NO DISKETTES 
ARE INSERTED INTO THE MACHINE. NEVER TURN THE MACHINE ON OR OFF 
WITH DISKETTES INSERTED IN IT. FAILURE TO OBSERVE THIS PRECAUTION 
WILL MOST DEFINITELY RESULT IN DAMAGE TO THE DISKETTES. 



SECTION 1 .0 

1.1 INTRODUCTION 

WELCOME TO THE WORLD OF COMPUSTAR! We are convinced 
that you will be impressed with the packaging, operation, relia- 
bility, and quality of your new Video Computer System. Your 
units have received special attention from design to preshipment 
testing in order to bring you a quality system. To protect this 
quality, we ask that you carefully follow the unpacking and 
system setup procedures. These procedures are designed to: 

- Reduce the risk of setup damage 

- Reduce the time required to make your system 
operational. 

This Compustar manual contains information covering 
unpacking, cable connections, and system operation. In addition, 
comprehensive information is included on specific items of 
interest to you, the user. Since many CompuStar users are 
familiar with computer processing, some sections of this manual 
will not be required reading. However, we strongly recommend 
that all users read the unpacking, system setup, and system 
operating instructions contained in Sections 1.0 and 2.0. In 
addition, all users should become familiar with the system 
technical information presented in Section 3.0. 

Sections 4 through 10 present more detailed information 
on the use of CP/M and will answer questions you may have 
concerning the operating system. Sections 11 through 13 present 
additional information concerning servicing and hardware/software 
updates. 

Thank you for purchasing the INTERTEC COMPUSTAR SYSTEM. 
We know this system will benefit you greatly in your environment 
and we are dedicated to insuring the continued success of your 
system through our 

- Optional On-Site Service Program (See Section 11) 

- Optional Extended Factory Warranty Service Program 
(See Section 11) 

- Optional Shared Service Program (See Section 11) 



SECTION 1.2 - SYSTEM UNPACKING INSTRUCTIONS 



1.2.1 Video Processing Unit (VPU) Removal 

Step V. NOTE: Because of the tight-fitting shipping 
carton, the removal of a VPU from its carton may require two 
people. One person may be required to hold the box on the floor 
while the other removes the unit from the carton. 

With the arrows on the carton pointing up, stand facing 
either side of the VPU. Grasp the unit along the top edge of the 
cover with the fingers of one hand. ( Caution : Excessive upward 
pressure on the cover top will result in damage to the cover.) 
With the fingers of the other hand, grasp the rear of the unit on 
the edge directly above the power cord. Lift the unit out of the 
carton (see Figure 1.2A) place it on the floor and remove the two 
foam packing inserts. Remove the protective plastic bag from 
around the terminal. DO NOT DISCARD THE PACKING INSERTS AND 
CARTON UNTIL YOU HAVE COMPLETELY CHECKED THE OPERATION OF THE 
VPU. 

Using the same lifting points as above, lift the VPU to 
a table and position the VPU to the front (user looking at 
keyboard). If the VPU is equipped with disk drives, remove the 
shipping tape from each disk drive. (See Figure 1.2B) IMPORTANT: 
THESE DOORS MUST BE TAPED AND ANY DISKETTES REMOVED IF THE UNIT 
IS EVER RESHIPPED. 

Step 2: Repeat Step 1 for all terminals in the system. 

1.2.2 Ten Megabyte Disk Storage System (DSS) Removal 

TOptional Equipment ) 

Step J_: Locate the package containing the diskette and 
remove from carton. Do not bend or otherwise damage the 
diskette. 

Step 2: Grasping the foam inserts, remove the Disk Storage 
System ("DSS) from the container and place on table. Remove the 
foam packing inserts and protective plastic bag. IMPORTANT: DO 
NOT CONNECT POWERCORD OF UNIT INTO WALL OUTLET. Turn the DSS on 
one side and remove the disk locking screw and strap. (See 
Figure 1.2C) The strap assembly should be saved in the event the 
unit is reshipped. Position the DSS to the front (user looking 
at POWER, READY, FAULT, and RESET buttons) and insure that ade- 
quate space is available around the unit for good air flow. 
( CAUTION : During operation do not restrict the flow of air 
through the bottom or sides of the DSS or put heavy items on top 
of the unit . ) 



FIGURE 1.2A REMOVAL OF VPU FROM CARTON 



FIGURE 1.2B REMOVAL OF SHIPPING TAPE FROM DISK DRIVE DOORS 



FIGURE 1.2C REMOVAL OF DSS LOCKING SCREW AND STRAP 



1.2.3 J_0 Megabyte DSS Cable Removal (Optional Equipment) 

Step _1_: Remove cable assemblies from their carton. (The 
number of cables should be one less than the total number of 
units in the system.) 

Example: One DSS and 2 terminals would require 2 cable 

One DSS, 2 terminals and 1 printer would 
require 3 cables. 

Place the cables near their respective units for later use. 

1.2.4 32 Megabyte DSS Removal (Optional Equipment) (To Be 

Provided 

1.2.5 32 Megabyte DSS Cable Removal (Optional Equipment) 
TTo Be Provided) 

1.2.6 96 Megabyte DSS Removal (Optional Equipment) (To Be 
Provided) 

1.2.7 96 Megabyte DSS Cable Removal (Optional Equipment) 
TTo Be Provided) 

1.2.8 Continuation 

The unpacking of your system is now complete. Please 
continue with the system setup instructions, Section 1.3. 



SECTION 1.3 - COMPUSTAR SYSTEM SETUP INSTRUCTIONS 



1.3.1 Designation of CompuStar VPU Number ( Station Number ) 

Step _1_: Insure that the powercord on each VPU is 
disconnected (unplugged). 

Step 2: If your unit has disk drives, insure that the drive 
doors are closed. Caution : Failure to close these doors could 
result damage when the cover is removed in Step 6. These doors 
may be closed by applying a slight pressure on the door pulling 
it back toward the VPU screen. 

Step _3: Remove the 5A fuse from the rear panel by pushing 
in on the fuse holder and rotating it counter-clockwise. 

Step _4: Position the VPU so that the two cover screws below 
the front of the keyboard extend slightly beyond the table edge. 
(See Figure 1.3A) Remove these two screws with a screwdriver. 

Step 5: Rotate the VPU so that the two rear cover screws 
above the power cord panel extend slightly beyond the table edge. 
(See Figure 1.3B) Remove these two screws. 

Step 6: Carefully remove the cover by lifting straight up 
after insuring that the disk drives doors are closed (Step 2). 

Step J_: Locate the VPU designator dipswitches on the rear 
of the unit (Figure 1.3C). (The switches represent binary counts 
with the least significant bit on the left when looking at the 
switch.) The switch has "on" and "off" markings on the side or 
on the top. Locate these markings. The switches are activated 
in the "off" position (depressing the "off" half of the switch). 
They are deactivated in the "on" position (depressing the "on" 
half of the switch). 

Table 1 . 3A presents the position of each switch for all 
possible VPU designations (1-255). For a CompuStar network con- 
taining less than ten VPUs, choose a unique VPU number between 
one and ten and set the switches according to Table 1. (NOTE: 
Other VPU numbers can be used but will require altering your 
CompuStar system as described in Section 2.1.3.) (For a network 
containing more than ten VPUs, assign a unique station number 
between 1 and 255. For these networks, it will be necessary to 
alter your CompuStar system upon completion of the system setup 
procedures. See Section 2.1.3.) 

Step _8: Replace the top cover. Do not accidentally change 
the switch setting as the cover is being positioned on the unit. 

Step 9: Replace the two rear cover screws. 



FIGURE 1.3A REMOVAL OF FRONT COVER SCREWS 



FIGURE 1.3B REMOVAL OF REAR COVER SCREWS 



FIGURE 1.3C VPU DESIGNATOR DIP SWITCHES 



XrOFF 

= ON 



TABLE 1 .3A, (SHEET 1) 



VPU 




VPU 




VPU 




NUMBER 


SETTING 


NUMBER 


SETTING 


NUMBER 


SETTING 


1 


XOOOOOOO 


43 


XXOXOXOO 


85 


XOXOXOXO 


2 


0X000000 


44 


OOXXOXOO 


86 


OXXOXOXO 


3 


XXOOOOOO 


45 


XOXXOXOO 


87 


XXXOXOXO 


4 


00X00000 


46 


OXXXOXOO 


88 


OOOXXOXO 


5 


xoxooooo 


47 


xxxxoxoo 


89 


XOOXOOXO 


6 


oxxooooo 


48 


ooooxxoo 


90 


0X0X00X0 


7 


xxxooooo 


49 


xoooxxoo 


91 


xxoxooxo 


8 


000X0000 


50 


oxooxxoo 


92 


ooxxooxo 


9 


xooxoooo 


51 


xxooxxoo 


93 


xoxxooxo 


10 


0X0X0000 


52 


ooxoxxoo 


94 


oxxxooxo 


11 


xxoxoooo 


53 


xoxoxxoo 


95 


xxxxooxo 


12 


ooxxoooo 


54 


oxxoxxoo 


96 


oooooxxo 


13 


xoxxoooo 


55 


xxxoxxoo 


97 


xooooxxo 


14 


oxxxoooo 


56 


oooxxxoo 


98 


oxoooxxo 


15 


xxxxoooo 


57 


xooxxxoo 


99 


xxoooxxo 


16 


0000X000 


58 


oxoxxxoo 


100 


ooxooxxo 


17 


xoooxooo 


59 


xxoxxxoo 


101 


xoxooxxo 


18 


0X00X000 


60 


ooxxxxoo 


102 


oxxooxxo 


19 


xxooxooo 


61 


xoxxxxoo 


103 


xxxooxxo 


20 


00X0X000 


62 


oxxxxxoo 


104 


oooxoxxo 


21 


xoxoxooo 


63 


xxxxxxoo 


105 


xooxoxxo 


22 


oxxoxooo 


64 


000000X0 


106 


oxoxoxxo 


23 


xxxoxooo 


65 


xoooooxo 


107 


xxoxoxxo 


24 


oooxxooo 


66 


0X0000X0 


108 


ooxxoxxo 


25 


xooxxooo 


67 


xxooooxo 


109 


xoxxoxxo 


26 


oxoxxooo 


68 


00X000X0 


110 


oxxxoxxo 


27 


xxoxxooo 


69 


xoxoooxo 


11 1 


xxxxoxxo 


28 


ooxxxooo 


70 


oxxoooxo 


112 


oooooxxo 


29 


xoxxxooo 


71 


xxxoooxo 


113 


xooooxxo 


30 


oxxxxooo 


72 


000X00X0 


114 


oxoooxxo 


31 


xxxxxooo 


73 


xooxooxo 


115 


xxoooxxo 


32 


00000X00 


74 


0X0X00X0 


1 16 


ooxooxxo 


33 


xooooxoo 


75 


xxoxooxo 


117 


xoxooxxo 


34 


0X000X00 


76 


ooxxooxo 


1 18 


oxxooxxo 


35 


xxoooxoo 


77 


xoxxooxo 


119 


xxxooxxo 


36 


00X00X00 


78 


oxxxooxo 


120 


oooxoxxo 


37 


xoxooxoo 


79 


xxxxooxo 


121 


xooxoxxo 


38 


oxxooxoo 


80 


0000X0X0 


122 


oxoxoxxo 


39 


xxxooxoo 


81 


xoooxoxo 


123 


xxoxoxxo 


40 


000X0X00 


82 


0X00X0X0 


124 


ooxxoxxo 


41 


XOOXOXOO 


83 


xxooxoxo 


125 


xoxxoxxo 


42 


0X0X0X00 


84 


00X0X0X0 


126 


oxxxoxxo 



X = OFF 












= ON 




TABLE 1.3A, 


(SHEET 2) 






VPU 




VPU 




VPU 




NUMBER 


SETTING 


NUMBER 


SETTING 


NUMBER 


SETTING 


127 


XXXXXXXO 


171 


XXOXOXOX 


213 


XOXOXOXX 


128 


OOOOOOOX 


172 


OOXXOXOX 


214 


OXXOXOXX 


129 


XOOOOOOX 


173 


XOXXOXOX 


215 


XXXOXOXX 


130 


OXOOOOOX 


174 


oxxxoxox 


216 


OOOXXOXX 


131 


XXOOOOOX 


175 


xxxxxxox 


217 


xooxxoxx 


132 


OOXOOOOX 


176 


ooooxxox 


218 


oxoxxoxx 


133 


xoxoooox 


177 


xoooxxox 


219 


xxoxxoxx 


134 


oxxoooox 


178 


oxooxxox 


220 


ooxxxoxx 


135 


xxxoooox 


179 


xxooxxox 


221 


xoxxxoxx 


136 


oooxooox 


180 


ooxoxxox 


222 


oxxxxoxx 


137 


xooxooox 


181 


xoxoxxox 


223 


xxxxxoxx 


138 


oxoxooox 


182 


oxxoxxox 


224 


oooooxxx 


139 


xxoxooox 


183 


xxxoxxox 


225 


xooooxxx 


140 


ooxxooox 


184 


oooxxxox 


226 


oxoooxxx 


141 


xoxxooox 


185 


xooxxxox 


227 


xxoooxxx 


142 


oxxxooox 


186 


oxoxxxox 


228 


ooxooxxx 


143 


xxxxooox 


187 


xxoxxxox 


229 


xoxooxxx 


144 


ooooxoox 


188 


ooxxxxox 


230 


oxxooxxx 


145 


xoooxoox 


189 


xoxxxxox 


231 


xxxooxxx 


146 


oxooxoox 


190 


oxxxxxox 


232 


oooxoxxx 


147 


xxooxoox 


191 


xxxxxxox 


233 


xooxoxxx 


148 


ooxoxoox 


192 


ooooooxx 


234 


oxoxoxxx 


149 


xoxoxoox 


193 


xoooooxx 


235 


xxoxoxxx 


150 


oxxoxoox 


194 


oxooooxx 


236 


ooxxoxxx 


151 


xxxoxoox 


195 


xxooooxx 


237 


xoxxoxxx 


152 


oooxxoox 


196 


ooxoooxx 


238 


oxxxoxxx 


153 


xooxxoox 


197 


xoxoooxx 


239 


xxxxoxxx 


154 


oxoxxoox 


198 


oxxoooxx 


240 


ooooxxxx 


155 


xxoxxoox 


199 


xxxoooxx 


241 


xoooxxxx 


156 


ooxxxoox 


200 


oooxooxx 


242 


oxooxxxx 


157 


xoxxxoox 


201 


xooxooxx 


243 


xxooxxxx 


158 


oxxxxoox 


202 


oxoxooxx 


244 


ooxoxxxx 


159 


xxxxxoox 


203 


xxoxooxx 


245 


xoxoxxxx 


160 


oooooxox 


204 


ooxxooxx 


246 


oxxoxxxx 


161 


xooooxox 


205 


xoxxooxx 


247 


xxxoxxxx 


162 


oxoooxox 


206 


oxxxooxx 


248 


oooxxxxx 


163 


xxoooxox 


207 


xxxxooxx 


249 


xooxxxxx 


164 


ooxooxox 


208 


ooooxoxx 


250 


oxoxxxxx 


165 


xoxooxox 


209 


xoooxoxx 


251 


xxoxxxxx 


166 


oxxooxox 


210 


oxooxoxx 


252 


ooxxxxxx 


167 


xxxooxox 


21 1 


xxooxoxx 


253 


xoxxxxxx 


168 


oooxoxox 


212 


ooxoxoxx 


254 


oxxxxxxx 


169 


xooxoxox 






255 


xxxxxxxx 


170 


oxoxoxox 











Step 10 : Replace the two front cover screws. 

Step 1 1 : Replace the fuse by rotating the fuse holder 
clockwise . 

Step 12 : Insure that the power switch located at the left 
rear corner (as you look at rear of VPU) is in the "off" position 

Step 1 3 : Verify that your VPU is wired for a line voltage 
that is available in your area. The correct line voltage may be 
determined from the serial tag located on the rear of your VPU. 
This tag should indicate either 110 or 220 VAC operation. DO NOT 
ATTEMPT TO CONNECT THE VPU TO YOUR LOCAL POWER OUTLET UNLESS THE 
VOLTAGE AT YOUR OUTLET IS IDENTICAL TO THE ONE SPECIFIED ON THE 
SERIAL TAG. Should the voltage differ, contact your dealer at 
once and do not proceed to connect the CompuStar system to the' 
power outlet. If the voltages are the same, connect the VPU 
powercord to the wall outlet. 

Step 1 4 : Repeat Steps 1 - 13 for each terminal. 

Step 15: If your system does not include a Disk Storage 
System (DSST7 continue with Section 2.1. If a DSS is included, 
continue with 1.3.2, 1.3-3, or 1.3.4. 

1.3.2 J_0 Megabyte Disk Storage System (DSS) Cable Connections 
and CompuStar System Test 

Step J_: Insure that the VPU switch is in the "off" 
position . 

Step 2: Select the cable assembly to be used between the 10 
megabyte DSS and an INTERTEC Model 20, 30, or 40 VPU (units which 
contain floppy disk drives). NOTE: If your system has only 
Model 10 units, proceed with steps 3 through 9, but substitute 
Model 10 for Model 20, 30, or 40. 

Step _3: Attach one end of the cable assembly to the rear of 
the DSS. Insure a good connection by tightening the two adaptor 
holding screws. 

Step _4: Attach the other end of the cable assembly to one 
of the chaining adaptors on the rear of the INTERTEC Model 20, 30 
or 40. Either of the chaining adaptor ports may be used. Insure a 
good connection by tightening the two adaptor holding screws. 

Step 5: Verify that your DSS is wired for the line voltage 
that is available in your area. The serial tag on the right rear 
of the DSS will indicate that your unit is set for either 110 or 
220 VAC operation. DO NOT ATTEMPT TO CONNECT THE DSS TO YOUR 
LOCAL POWER OUTLET UNLESS THE VOLTAGE AT YOUR OUTLET IS IDENTICAL 
TO THE ONE SPECIFIED ON THE BACK OF THE DSS. Should the 
voltages differ, contact your dealer at once and do not connect 
your DSS to the power outlet. Before connecting the DSS to the 
wall outlet, be sure that the power switch located on the left 



wall outlet, be sure that the power switch located on the left 
front is OFF (extended out of the front panel the same distance 
as the "Ready" switch). NOTE: Also make sure the disk locking 
strap has been removed (see Section 1.2.2, Step 2). Your DSS can 
be damaged if power is applied with the locking strap attached. 

Connect the DSS power plug to the wall outlet. Push the POWER 
switch on the front of your DSS. At this time, you should hear a 
faint "whirring" sound coming from the fan inside the DSS. Both 
the red light on the POWER switch and the green light on the 
READY switch will be on. The READY FAULT and RESET switch lights 
will be off. Press the RESET switch at this time. 

Step 6: Put the POWER switch located at the left rear 
corner of the VPU in the "ON" position if the line voltage is the 
same as the VPU required voltage (Section 1.3.1, Step 13). 

Step 7: Refer to Section 2.1.4 for the test procedure to 
insure your VPU is functioning properly. Upon completion of 
these tests, return to step 8 below. 

Step 8: If another INTERTEC Video Processing Unit (Model 
10, 15, 20, 30 or 40) is to be used in the system, attach a 
cable assembly between the unused chaining adaptor of the tested 
VPU (setup in Step 4) and the untested VPU. REFER TO FIGURE 1 .3D 
(Typical System Configurations) FOR ADDITIONAL PICTORIAL INFORMA- 
TION CONCERNING INTERUNIT CABLE CONNECTIONS. Now repeat steps 6 
and 7 for this VPU. Continue to repeat steps 6, 7, and 8 until 
all units have been connected and tested. Then proceed to step 
9. 

Step 9.: The setup of your system is now complete. Please 
continue with the System Operating Instructions. 
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1.3*3 : 32 Megabyte Disk Storage System (DSS) cable connec 
tion and System test (to be added). 
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SECTION 2.0 

2.1 COMPUSTAR SYSTEM 
OPERATING INSTRUCTIONS 

2.2 PRACTICAL HINTS 

2.3 VIDEO DISPLAY FEATURES 

2.4 SERIAL INTERFACING 

2.5 SUPERBRAIN AND DSS 
OPERATING INSTRUCTIONS 



COMPUSTAR SYSTEM OPERATING INSTRUCTIONS 



2. 1 .0.0 OVERVIEW 

Your CompuStar Computer System can consist of as few as one Video 
Processing Unit (VPU) or as many as 255 VPUs and a Disk Storage 
System (DSS). This section of the manual will explain how to use 
your CompuStar system in any or all of these configurations. Each 
Model 20, Model 30, or Model 40 VPU, as shipped from the factory, 
is capable of operating as a stand-alone computer, quite similar 
to our popular SuperBrain Video Computer System. You may choose 
to operate your VPU in this manner, and later add the DSS and 
other VPUs. If you purchase a DSS, you should know that these 
units are configured at the factory, and you may simply attach 
your VPUs and begin processing. Also, you may change the con- 
figuration of the DSS storage layout, allocating more or less 
disk space to each station. There are portions of this section of 
the manual devoted to each of these concerns. 

It is recommended that you carefully read each of the sections in 
this part of the manual, as this will familiarize you with the 
hardware and software of the computer system. If you are going to 
use your VPU as a stand-alone computer, the section entitled 
"Using your CompuStar VPU as a Stand-Alone Computer" will 
describe its operation. The general system of the CompuStar 
network is described in "Layout of a CompuStar System", and if 
you ever wish to employ CompuStar's multi-user capabilities, you 
should carefully study this section. The steps needed to change a 
DSS allocation scheme can be found in "Altering a CompuStar 
System". Again, read all sections thoroughly, and reread other 
sections again as needed. 



■ 



SECTION 2.1.1.0 

2.1.1.0 LAYOUT OF A COMPUSTAR SYSTEM WITH A 10 MEGABYTE DSS 

An operating system is a computer program that controls your 
computer system, properly maintaining its resources, such as the 
video, memory, peripherals, etc. A Disk Operating System, or DOS, 
is an operating system that resides on a disk. Using a DOS, files 
are brought into memory as needed, and therefore, memory usage is 
lessened. Your CompuStar Computer System uses standard CP/M as 
its Disk Operating System. A copy of the operating system exists 
in each user station and makes CompuStar a true computer net- 
work. This enables the user at each station to enjoy the benefits 
of his own computer terminal while allowing users to share the 
common data and program files located on the computer disk. 

A computer disk has a magnetic oxide coating to enable data to be 
recorded upon it, similar to an audio recording device. The heads 
in the disk drive read from and write data to the disk. The disk 
rotates like a phonograph record, and the head positions itself 
at the proper point on the disk for the desired operation. Unlike 
a phonograph record, data on a disk is not kept in a spiral 
fashion, but instead the disk is divided into rings of concen- 
tric circles called tracks. The tracks are further divided into 
sectors. The operating system maintains a directory specifying 
the sectors which are vacant and the sectors which contain data. 
By viewing a directory of your disk, you can see a list of all 
files which exist on that disk. 

CP/M gives each disk drive a name. The names are 'A f for the 
first drive, l B l for the second, and so on, up to 'P' for the 
sixteenth disk drive. Each VPU Model (20, 30, or 40) will con- 
tain its own floppy disk drives A and B. These are accessable 
only by the stations themselves. A CompuStar ten megabyte DSS 
will contain the drives C, D, and E, and there is special signi- 
ficance to this drive scheme. An area will exist for each user 
on the DSS that will be like drives A and B - accessable only by 
each individual station. This disk space is called drive C and 
appears to be just another drive to the station. However, the 
area called drive D is the shared by all users. Thus, files that 
need to be common are kept in drive D. Further, drive E will be 
used by the print spooler (details for the print spooler will be 
available in the near future). 

In a CompuStar Computer System, data files could be kept in the 
common area, drive D. These files would be available to any sta- 
tion in the network. You could use the local storage in a VPU 
with A and B disk drives to 'back up* the data on the DSS (this 
is STRONGLY RECOMMENDED), and thereby preserve a copy of the 
files in case of erroneous erasure. Data and programs needed only 
by one station could be placed on that station's drive C, and 
lightning-fast access to disk files would be available. Refer to 
Figure 2.1A for a typical CompuStar Computer System configura- 
tion . 
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FIGURE 2.IA DISK STORAGE SYSTEM ( DSS ) ALLOCATIONS 



In standard CP/M computer systems, the operating system is loaded 
from the first two tracks of the first disk drive, which is 
usually denoted as drive A. This is true for the SuperBrain and 
CompuStar VPU Models 20, 30, and 40, which each have two disk 
drives denoted A and B. However, the Model 10 VPU does not have 
any disk drives. For this model, the operating system is loaded 
from drive C, which is the first drive for a Model 10. Drive C is 
located in the DSS and is unique for each station in a CompuStar 
system. Please note that a copy of the CompuStar operating system 
exists in each drive C - this enables you to freely swap Model 10 
VPU's with other VPU models in your system. 

Drive C is the storage area on the Disk Storage System (DSS) that 
is unique to each station in a CompuStar system. In configuring 
your network, you may divide the area on the DSS in any fashion 
you wish until you expend the 8.4 megabytes of formatted disk 
space on the unit. No station can be attached to the DSS network 
unless disk space has been allocated for that station. Drive D is 
the area on the DSS that is common to all stations in the net- 
work, and drive E denotes the area devoted to the system print 
spooler . 

As shipped from the factory, a 10 Megabyte Disk Storage System is 
configured for ten stations, numbered 001 through 010. If you 
plan to use your CompuStar system in the factory-configuration, 
you must set the dipswitches in each station in the range of 001 
to 010 (refer to section 1.3.1 of the installation instructions 
for more details). Each station has approximately 250 kilobytes 
allocated for its drive C. The print spooler area has been allo- 
cated 250 kilobytes, and the remaining area is allocated to drive 
D. This provides common disk storage of approximately 6000 kilo- 
bytes, or 6 megabytes. Included with the DSS is a diskette to be 
used with a Model 20, 30, or 40 VPU for reallocating the DSS 
storage areas for different configurations. Please note that it 
is not necessary to have all ten stations in order to use the DSS 
as shipped. Additional units may be added later. However, if you 
wish to add more than ten stations, or if you desire other disk 
allocations, you will have to initialize and configure the DSS 
yourself. The exact procedure for this is described in the sec- 
tion ALTERING A COMPUSTAR SYSTEM. 

If you plan to use any CompuStar VPU with local disk storage 
(Model 20 VPU, 30 VPU, or 40 VPU) in your CompuStar network, you 
will have to use a different operating system from the one that 
is shipped with the unit to enable network communication. A 
special utility program will install the operating system on 
your VPU diskette, and is provided on the diskette shipped with 
the DSS. This program is called M0DxxD0S.COM, where xx is either 
20, 30, or 40, depending on the VPU type. Please select the 
correct program for your VPU type, as the wrong one will not work 
properly. Detailed instructions on the use of this program can be 
found in the section of this manual called ALTERING A COMPUSTAR 
SYSTEM. 



2.1.1.1 10 MEGABYTE OPERATING INSTRUCTIONS 



Operation of the DSS 10 is really quite simple. You should only 
be concerned with a few aspects. On the front of the unit are 
four push switches. The leftmost switch is for power. When this 
switch is depressed the unit should power up, and the switch 
should light. Also, the READY switch next to the POWER switch 
should light. After power is applied, press the RESET switch to 
insure that the unit is operable. If the READY light flickers, 
this indicates some station in the network has accessed the disk. 
Otherwise, the light on the READY switch remains on. 

NOTICE: If the FAULT light on the ten megabyte DSS comes on, this 
indicates that the DSS was unable to complete a communication 
link with one of the stations. When this occurs, you must reset 
the DSS before further use or it will remain inoperable. To 
reset the DSS, simply press the switch marked RESET. The unit 
should then resume normal operation. If the FAULT light remains 
on or if you are experiencing frequent disk faults, contact your 
Intertec representative. 



SECTION 2.1 .2 



2.1.2.0 OPERATING A COMPUSTAR VPU AS A STAND-ALONE COMPUTER 

As shipped from the factory, your CompuStar Video Processing Unit 
Model 20, 30, or 40 can be operated as a stand-alone computer. 
This means that you do not have to have a Disk Storage System to 
enjoy CompuStar 's power and you may begin computing with any VPU 
that features local disk drives. When used without the DSS, the 
VPU behaves much like Intertec's popular SuperBrain Computer 
System. Both the SuperBrain and the CompuStar feature CP/M as 
their operating system. Before proceeding with operating your 
CompuStar VPU, it is suggested that you read Section 2.2 of the 
manual. This section should also be read if you wish to use a VPU 
Model 20, 30, or 40 in a CompuStar network. 

Now that you have removed your CompuStar VPU from the packing 
carton, you are ready to begin to set up the system. The first 
step in this procedure is to verify that your CompuStar is wired 
for the line voltage that is available in your area. This can be 
ascertained by looking at the serial tag located at the right 
rear of the terminal. This tag will indicate if your terminal is 
set up for either 110 or 220 VAC operation. DO NOT ATTEMPT TO 
CONNECT THE COMPUSTAR VIDEO PROCESSING UNIT TO YOUR LOCAL POWER 
OUTLET UNLESS THE VOLTAGE AT YOUR OUTLET IS IDENTICAL TO THE ONE 
SPECIFIED ON THE BACK OF YOUR TERMINAL. Should the voltages 
differ, contact your dealer at once and do not proceed to connect 
the CompuStar VPU to the power outlet. 

Before connecting the CompuStar VPU to the wall outlet, be sure 
that the power switch located at the left rear corner is turned 
OFF. You may now proceed to connect the computer system to the 
wall outlet. Next, turn the power switch on the rear of your VPU 
on. At this time, you should hear a faint 'whirring' sound coming 
from the fan inside the VPU. After approximately 60 seconds the 
message 'INSERT DISKETTE INTO DRIVE A' will appear on the screen. 
If this message does not appear after 60 seconds, simultaneously 
depress both RED keys on either side of the keyboard. These are 
the master reset keys and should reinitialize the computer system 
and cause the 'INSERT' message to appear. If, after several 
attempts at resetting the equipment, you are unable to get this 
message to appear on the screen, turn the unit off for approxi- 
mately 3 to 5 minutes and then reapply power. Also, check the 
brightness adjustment on the rear of the computer's panel, 
turning the knob clockwise to increase the brightness level. If 
you are still unable to get the appropriate message on the 
screen, contact your Intertec representative. 



2.1 .2. 1 SYSTEM DISKETTE 

Now that you have applied power to the machine and the 'INSERT 
DISKETTE' message has been displayed in the upper left corner of 
the screen, you are ready to proceed with 'loading the computer's 
operating system. To do this you will need the 5 1/4" diskette 
that was packed in this manual. Notice that a small adhesive 
strip has been placed over the notch on the right side of the 
diskette. This aluminum strip is used to 'WRITE PROTECT' the 
diskette. Therefore, you may only load and/or read programs from 
this diskette. If you wish to write or save programs on the 
system diskette it will be necessary to remove this strip. This 
is NOT RECOMMENDED as it will subject your diskette to accidental 
errors that may be induced by you while you are becoming familiar 
with the operating system. 

You are now ready to proceed with inserting the system diskette 
into the machine. When facing the front of the machine, notice 
the disk drives in the upper right corner. The one on the left is 
drive A, and the one on the right is drive B. It is important to 
distinguish the two drives, because the operating system will 
only load from drive A. Now open the disk drive door on drive A. 
This is done by applying a very slight outward pressure on the 
small flat door on the center of the opening. Once open, you may 
now insert the Operating System Diskette. There is a label on the 
diskette that describes the version of the operating system you 
have received. For proper insertion, please be sure that (1) the 
small aluminum 'WRITE PROTECT' strip is oriented toward the top 
edge of the diskette, and that (2) the label located on the 
diskette is away from the screen. Refer to Figure 2.1B for fur- 
ther help. It is EXTREMELY important that all diskettes are 
inserted with the proper orientation since they are inoperable 
otherwise. Applying gentle pressure on the rear the diskette, 
push it all the way into the opening. Now reclose the drive door, 
pulling it in the opposite direction from which it was opened. 

Once the door is closed, you may hear a 'swishing' sound. This is 
normal and indicates that the VPU is loading the operating 
system. Some drives are quieter than others and therefore this 
noise may be inaudible. The following message should appear in 
the upper left corner of the screen: 

64K COMPUSTAR STAND-ALONE DOS VER 1.0 FOR CP/M 2.2 
A> 

If this message does not appear on the screen, simultaneously 
depress the two RED keys located on either side of the keyboard. 
This is how the VPU is reset, and this action should cause the 
operating system to reload. If, after several seconds, this 
message does not appear on the screen, try depressing the RED 
keys several more times. If this proves unsuccessful, then open 
the disk drive door on drive A and remove the system diskette, 
making certain that it has been properly inserted. Refer to 
Fugure 2.1A for further help with diskette insertion. Recall that 
the operating system will not load unless the diskette has been 



FIGURE 2. IB PROPER INSERTION OF DISKETTE 



correctly inserted. Once you are certain that the diskette has 
been correctly placed into disk drive A, close the door and again 
depress the RED keys simultaneously . If after repeated depres- 
sions the indicated message does not appear on the screen, 
contact your Intertec representative. 
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REVIEWING THE SYSTEM DISKETTE 



Now that 


you have sucessfully loaded the System Diskette and the 


Disk Operating System (DOS), your CompuStar VPU is ready to 


accept your disk operating system commands. Now we shall review 


several of 


the commands on the operating system. However, it is 


recommende 


d that you refer to the appropriate section of this 


manual for 


a detailed description of all such commands (Section 4 


- Introduc 


tion to CP/M features and Facilities). The most used 


system command is the DIR command. This command instructs your VPU 


to display 


the directory of all files on the disk. To enter this 


command , 


simply enter 'DIR' on the keyboard and push the RETURN 


key. The 


computer should respond by displaying contents similar 


to this: 




A>DIR 




A:ED 


COM : DDT COM : SYSGEN COM : PIP COM 


A: ASM 


COM : STAT COM : LOAD COM : DUMP COM 


A:64KTEST 


COM : CS20BIOS ASM : SUBMIT COM : XSUB COM 


A:CS20CPM 


COM 



A> 



To obtain a better understanding of what this information 
let's take a look at the first entry: 



means 



A:ED 



COM 



The first letter on this line is A. This indicates that the 
information following this letter is on drive A, which is the 
first drive in CP/M systems. The colon serves as a separator 
between the drive designator and the other information. The name 
of this file is "ED", and the file type is "COM". A more detailed 
treatment of this information can be found in other sections of 
this manual (Section 4 - An Introduction to CP/M Features and 
Facilities and Software Addenda). 

IMPORTANT NOTE: Some of the system disk programs may have a two 
digit number suffixed to the file name (i.e., PIP22 instead of 
just PIP). This suffix is used to indicate the actual revision 
and/or version level of the program. 



2. 1.2.3 



DUPLICATING THE OPERATING SYSTEM DISKETTE 



Now that you have sucessfully loaded the Disk Operating System 
into drive A, it is important to duplicate this diskette onto 
another diskette. You should never remove the small aluminum 
'WRITE PROTECT' strip covering the notch on the top edge of the 
System Diskette, or change or erase any files on this diskette. 



You should make a duplicate of this diskette, and then store the 
original in a safe place. To copy this diskette, you will first 
need a blank diskette. We recommend an Intertec 1121010 diskette 
for this purpose. If you do not have any blank diskettes of 
similar quality, please contact the representative from whom you 
purchased your equipment. He should be happy to provide you with 
an ample supply of these diskettes. 

Insert the blank diskette into drive B. Follow the procedure 
outlined in the previous paragraphs regarding the insertion of 
the operating system diskette. The only difference is that you 
will be placing the diskette into drive B. Be sure to leave the 
system diskette installed in drive A. Once installed, three 
separate steps are necessary to completely duplicate the diskette 
in drive A. First, the diskette in drive B must be formatted. 
Secondly, you must copy all of the files to the new diskette. 
Thirdly, the operating system must be copied to the new diskette. 
You must use a separate procedure to copy files and operating 
systems. Each of these steps are described in greater detail in 
the paragraphs that follow. 

FORMATTING: All new diskettes must be formatted before attempting 
to read or write upon them. This is necessary because the infor- 
mation stored on these diskettes is in a SOFT-SECTORED FORMAT. 
The operating system divides the diskette into SECTORS. The 
system program called FORMAT tells the operating system where the 
sectors are on the diskette and which are in use. 

To use the FORMAT program, you must have the program F0RMAT.COM 
on a formatted diskette in drive A. Type FORMAT on the keyboard 
and then push the RETURN key. You will be asked to select the 
diskette type next. Respond with f S' for the single-sided disk- 
ettes used on a CompuStar VPU Model 20, 'D f for double-sided 
diskettes used in a CompuStar VPU Model 30, or 'A' for diskettes 
used in a CompuStar VPU Model 40. Next type 'F' when ready to 
begin the format process. You will hear drive B re-set to track 
and rewrite information to each track (there are 10 sectors per 
track). The formatting program will display each track as it is 
formatted . 

After the diskette has been formatted, you will be asked whether 
you wish to REBOOT the operating system or format another disk. 
If you wish to continue formatting diskettes, remove the newly 
formatted diskette from drive B and replace it with an unfor- 
matted diskette. Then repeat the above process for each diskette 
you wish to format. If you do not wish to format any more 
diskettes, simply push the RETURN key. This will reload the 
operating system and once again the VPU will be ready to accept 
your commands. 
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PIP: Since our original intent was to copy the original System 
Diskette, we may now proceed with the file transfers. This is 
done by entering the following command on the keyboard: 

PIP B:=*.*[V] 



Be sure 
command . 



to push the RETURN key after you have typed out the 



PIP is actually a file on the diskette that CP/M systems use for 
file transfer. PIP stands for Peripheral Interchange Program, and 
more information on PIP can be found in Section 4 of this manual 
(An Introduction to CP/M Features and Facilities). The PIP 
command above instructs the computer system to copy each file on 
drive A onto drive B. As each program is copied, its name will be 
displayed on the screen. This procedure will take approximately 5 
to 10 minutes. After the procedure is complete, the control of 
the operating system will be returned to the user. If this proce- 
dure does not complete, you will see a message indicating the 
error. Below are listed some possible messages and your response. 



MESSAGE 



ACTION TAKEN 



*** disk not ready *** 



Make sure the disk drive doors 
are closed. 



*** disk not ready *** 



Bdos Err on B: Bad Sector 



Bdos Err on B: Select 



Bdos Err on B: R/0 



You are attempting to copy 
data to an unformatted dis> 
kette. Format and repeat. 

Disk not formatted properly. 
Reformat and repeat. 

You did not specify the 
correct disk drive. Make sure 
you entered ' B' . 

You probably have a 'WRITE 
PROTECT' strip over the notch 
on the top edge of the disk- 
ette. Remove and try again. 



11 



SYSGEN: Now that you have copied the operating system's programs 
from drive A to drive B, you are ready to copy the operating 
system itself. The operating system resides on tracks and 1 of 
the diskette, and these tracks are inaccessable to other files. 
To make this transfer, type the following command an the keyboard 
(followed by the RETURN key): 

SYSGEN 

The SYSGEN command is used to generate an operating system and 
place it on the desired diskette. Once you have entered this 
command you will select the source disk (where to get the operat- 
ing system) and the destination diskette (where to place the 
copy). In our case, the source response is 'A' and the destina- 
tion response is 'B'. SYSGEN will ask you to indicate when the 
diskettes are loaded, and you press the RETURN key when you have 
inserted the diskettes in the proper drives. This procedure will 
inform you when it is finished. As in the FORMAT program, you 
may repeat this process on another diskette if you desire. To 
copy another operating system, remove the diskette from drive B 
and replace it with another diskette. Push the RETURN key to 
reload the operating system and proceed. 

Now you can remove the system diskette - from drive A. Remove the 
diskette in drive B and place it in drive A. Refer to the pre- 
vious section for proper diskette orientation. Once the newly 
copied diskette from drive B is in drive A, close the door to the 
drive. Reset the computer system by simultaneously depressing 
both RED keys located on -either side of the keyboard. This will 
force the computer to reload the operating system from the 
diskette - the one you just copied. Use this diskette while 
becoming familiar with your computer system, and place the 
system diskette in a safe place in case one copy is destroyed or 
otherwise damaged (see Section 2.2.2.0 DISKETTE PRECAUTIONS). 

IMPORTANT: If you reset the computer with the newly copied disk- 
ette and garbled text appears on the screen, an error was made in 
the use of the 'SYSGEN' program. If this is the case, then remove 
the diskette from drive A, replace it with the system diskette, 
and repeat the previously outlined procedure for copying the 
system diskette. If you continue to encounter difficulties, 
please read Section 4 of this manual entitled "An Introduction to 
CP/M Features and Facilities" for a complete review of the system 
program SYSGEN. 

Now that you have sucessfully copied the system diskette, please 
read Section M of this manual entitled "An Introduction to CP/M 
Features and Facilities" for a complete description of each of 
the operating system programs (DDT.COM, PIP.COM, SUBMIT.COM, 
etc . ) . 
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2.1.3 ALTERING A COMPUSTAR SYSTEM 

If you wish to change your CompuStar disk allocations, you will 
have to perform some initialization tasks. These procedures 
include a disk format program and allocation of user, common, and 
print spooler areas on the Disk Storage System (DSS). Note that 
all user stations can have exclusive disk storage at the DSS 
called drive C. Further, the common area or drive D, is 
available to any user station in the network. The print spooler 
area (drive E) is also available to any network user. 

Before proceeding please be certain the the following has been 
done : 

ALL CABLES TO THE VPU's ARE PROPERLY CONNECTED 

ALL DIPSWITCHES FOR STATION NUMBER HAVE BEEN SET 

ALL USER STATIONS ARE POWERED OFF 

YOU HAVE AT LEAST ONE VPU MODEL 20, MODEL 30, OR MODEL 40 

YOU HAVE AN EXTRA FORMATTED DISKETTE 

NOTE: You cannot alter your CompuStar DSS configurations until 
you are familiar with the operation of a stand-alone CompuStar 
VPU. This section assumes that you understand this kind of 
operation. Please study the contents of the section of this 
manual entitled ♦ OPERATING A COMPUSTAR VPU AS A STAND-ALONE 
COMPUTER' prior to altering a CompuStar DSS. 

First, turn on the power to the station (Model 20, 30, or 40) 
that you will use to initialize the DSS. This unit must have 
local disk drives since the initialization procedures are on a 
diskette. Next, ope'n the door of the left drive of the initiali- 
zation station - this is drive A. Place the COMPUSTAR INITIALI- 
ZATION DISKETTE into it. Refer to Figure 2.1B for correct disk- 
ette orientation. Close the door and then simultaneously depress 
the RED keys at the bottom of the keyboard. The unit will now 
load the special initialization operating system. The following 
message should appear at the top left corner of the screen: 

64K COMPUSTAR INITIALIZATION DOS VER 0.1 FOR CP/M 2.2 COM 

WARNING — THIS PROGRAM WILL ERASE ALL HARD DISK DATA 

DO NOT USE THIS DISKETTE UNTIL YOU HAVE READ SECTION 2.1.3 OF YOUR 
COMPUSTAR MANUAL! 

If this does not appear, try depressing the RED keys again. If 
repeated depressions of the RED keys do not produce the above 
message, then contact your Intertec dealer. You cannot alter the 
DSS unless this operating system is loaded in the initialization 
station. This operating system will work in every Model 20, 30, 
or 40 VPU. 
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The initialization and allocation programs will first format the 
DSS and then obtain from you the amount of disk area you wish 
to devote to each user station. You may allocate areas for sta- 
tions to be added later, otherwise you will destroy the DSS's 
contents if you should decide to repeat this process. Once these 
areas have been assigned, they cannot be changed or reassigned 
without destroying the DSS data. Since the initialization uses 
CP/M's SUBMIT program, aborting the routine will not work pro- 
perly (for a review of SUBMIT, see section 4 of this manual). 
Therefore, it is mandatory to know how you wish to configure the 
DSS before you start. 

Once the special initialization DOS has been properly loaded into 
the VPU (using the diskette contained in the box with your DSS) , 
and you are sure that the power is off at all other VPUs in the 
CompuStar network, you may proceed with the initialization pro- 
cess. Type in the following line at the keyboard: 

SUBMIT22 STARGEN 

A program on the diskette called STARGEN. SUB contains the names 
of the system programs needed to initialize the DSS. First, the 
DSS will be formatted. If you notice, the FAULT light on the DSS 
will come on during the formatting. This is normal, and indi- 
cates that nothing is wrong. Do not reset the DSS until later. 

The DSS may have media errors on it. This means that some of the 
tracks on the disk may not be usable. Supplied with your DSS is 
a buff-colored card labeled 'SA1004 MEDIA ERROR MAP'. On this 
card is listed the media defects on your drive. It is necessary 
for you to enter the tracks and heads listed on the card so that 
these may be reassigned. As the head positions itself on a 
defective track, it will then reposition itself to an alternate 
track area. This makes the defective tracks transparent to the 
user. After you have entered all defective tracks, enter 'D' for 
a display of your entries for verification purposes. Then enter 
'X' to exit the alternate track assignments and proceed. 

There are approximately 8800 kilobytes (8.8 megabytes) of for- 
matted disk area on the DSS. The first area you will be asked to 
allocate is the common area - drive D. Enter the amount in kilo- 
bytes and push the RETURN key. Repeat the process for drive E, 
the print spooler area. Next enter the allocations for each 
stations' exclusive area, drive C. Here you will enter a station 
number (any number from 1 to 255), and again the number of 
kilobytes you wish to allocate. The station numbers do not have 
to be in any order and do not have to be contiguous. NOTE: 
Allocate area for any future stations at this time, because the 
allocation process destroys the data on the DSS. This routine 
will display the number of bytes remaining as each entry is made. 
You may also enter 'D' to review which stations and areas have 
been allocated in the process at any time. To terminate entry, 
enter 'E' and push RETURN. 
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After you have made all of your entries and have entered ! E f , the 
initialization procedure will complete some final tasks and 
return to the operating system. One more step is now needed to 
complete the process. You must have a different operating system 
on the diskette to use a VPU with local disk drives (any Model 
20, 30, or 40) in a CompuStar network. The operating system that 
comes with the unit will not work with a CompuStar network, 
because its original operating system is designed to treat the 
VPU as a Stand-Alone computer. You must place a copy of the new 
operating system on another formatted diskette. A utility program 
called MODxxDOS should be run (xx is 20 for a VPU Model 20, 30 
for a VPU Model 30, or 40 for a VPU Model 40). Notice - you 
cannot use the CP/M system program SYSGEN to do this because the 
diskette in drive A contains a special initialization DOS, and 
you actually need another DOS elsewhere on the diskette. MODxxDOS 
will insure this transfer. However, once you run the MODxxDOS 
program, the diskette in drive B will contain the VPU's network 
operating system in drive B. Subsequent operating system trans- 
fers from that diskette should be performed via the SYSGEN com- 
mand (For a review of SYSGEN and FORMAT, please see section 4 of 
this manual, AN INTRODUCTION TO CP/M FEATURES AND FACILITIES). 
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This is a sample session in which a CompuStar DSS is configured 
for five user stations. The underlined portions in this 
demonstration are entered by the user, and ! (cr) f means that the 
RETURN key should be pressed here. 

64K COMPUSTAR INITIALIZATION DOS VER 0.1 FOR CP/M 2.2 COM 

A>SUBMIT STARGEN (cr) 

COMPUSTAR 10 MBYTE DISK GENERATION PROGRAM VER 0.1 

CAUTION — THIS PROGRAM DESTROYS ALL PREVIOUSLY RECORDED DATA 

TYPE "G" AND PRESS THF RETURN KEY TO BEGIN G (cr) 

FORMAT OPERATION IN PROGRESS 

(Note - Here is when the fault light comes on at the DSS — THIS IS 

NORMAL! DO NOT PUSH THE RESET KEY AT THIS TIME!) 

FORMAT ALTERNATE TRACKS (Y/N): Y (cr) 

ENTER DEFECTIVE TRACK NUMBER (OR 'D' FOR DISPLAY, 'X 1 FOR EXIT): 
210 (cr) 

ENTER DEFECTIVE HEAD NUMBER 

ENTER DEFECTIVE TRACK NUMBER (OR f D» FOR DISPLAY, 'X' FOR EXIT) : 
D (cr) 

TRACK HEAD These will be reassigned 
0210 0000 

ENTER DEFECTIVE TRACK NUMBER (OR »D» FOR DISPLAY, 'X' FOR EXIT): 
X (cr) 

8799 KBYTES OF DISK SPACE REMAINING 

ENTER NUMBER OF KBYTES REQUIRED FOR THE COMMON PARTITION 
(MAX = 8400) 5000 

5004 KBYTES ALLOCATED TO PARTITION 
3795 KBYTES OF DISK SPACE REMAINING 

ENTER NUMBER OF KBYTES REQUIRED FOR PRINT SPOOLER PARTITION 
(MAX = 8400) 250 

0252 KBYTES ALLOCATED TO PARTITION 

3543 KBYTES OF DISK SPACE REMAINING 

ENTER STATION NUMBER (1-255), "END", OR "DISPLAY" 1 (cr) 

3543 KBYTES OF DISK SPACE REMAINING 

ENTER NUMBER OF KBYTES REQUIRED FOR STATION 001 250 

0252 KBYTES ALLOCATED TO PARTITION 

3291 KBYTES OF DISK SPACE REMAINING 

ENTER STATION NUMBER (1-255), "END", OR "DISPLAY" 2 (cr j 



16 



3291 KBYTES OF DISK SPACE REMAINING 

ENTER NUMBER OF KBYTES REQUIRED FOR STATION 002 250 

0252 KBYTES ALLOCATED TO PARTITION 

3039 KBYTES OF DISK SPACE REMAINING 

ENTER STATION NUMBER (1-255), "END", OR "DISPLAY" 3 (cr) 

3039 KBYTES OF DISK SPACE REMAINING 

ENTER NUMBER OF KBYTES REQUIRED FOR STATION 003 250 

0252 KBYTES ALLOCATED TO PARTITION 

2787 KBYTES OF DISK SPACE REMAINING 

ENTER STATION NUMBER (1-255), "END", OR "DISPLAY" 4 (cr) 

2787 KBYTES OF DISK SPACE REMAINING 

ENTER NUMBER OF KBYTES REQUIRED FOR STATION 004 250 



0252 KBYTES 
2535 KBYTES 



ALLOCATED TO PARTITION 
OF DISK SPACE REMAINING 



ENTER STATION NUMBER (1-255), "END", OR "DISPLAY" 5 (cr) 



2535 KBYTES OF DISK SPACE REMAINING 

ENTER NUMBER OF KBYTES REQUIRED FOR STATION 005 



2500 



2507 KBYTES ALLOCATED TO PARTITION 

0028 KBYTES OF DISK SPACE REMAINING 

ENTER STATION NUMBER ( 1 -255 ) , "END" , OR "DISPLAY" D (cr) 



COMMON AREA 
PRINT SPOOLER 
STATION 001 
STATION 002 
STATION 003 
STATION 004 
STATION 005 
0028 KBYTES OF 
ENTER STATION 

A>HUBGEN 



5004 


KBYTES ALLOCATED 


TO 


PARTITION 


0252 


KBYTES ALLOCATED 


TO 


PARTITION 


0252 


KBYTES ALLOCATED 


TO 


PARTITION 


0252 


KBYTES ALLOCATED 


TO 


PARTITION 


0252 


KBYTES ALLOCATED 


TO 


PARTITION 


0252 


KBYTES ALLOCATED 


TO 


PARTITION 


2507 


KBYTES ALLOCATED 


TO 


PARTITION 


DISK SPACE 


REMAINING 






NUMBER (1-255), "END", OR "DISPLAY" E (cr) 



A>MD10GEN 



A> 



(Note - This is when you press the RESET button on the DSS) 



A> MOD20DOS 
SYSGEN VER 1 .4 
SOURCE DRIVE NAME 
DESTINATION DRIVE 
DESTINATION ON B, 
FUNCTION COMPLETE 
DESTINATION DRIVE 



(OR RETURN TO SKIP) (cr) 
NAME (OR RETURN TO REBOOT) 
THEN TYPE RETURN (cr) 



B (cr) 



NAME (OR RETURN TO REBOOT) (cr) 



A> 
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2.1.4 YPU SYSTEM TEST 

It is necessary to make certain that all VPUs are capable of 
communicating with the Disk Storage System. To do this, it is 
suggested that each VPU be attached to your CompuStar network and 
tested one at a time. This will systematically insure each 
terminal's operation before others are attached to the network. 

If you are testing a VPU that has its own disk drives, it will be 
necessary to initialize a disk operating system that will permit 
network communcation . Recall that these units are designed to 
operate in a stand-alone mode as shipped from the factory. 
Therefore, you only need to copy the network operating system 
onto another diskette to test the unit. These special operating 
systems can be generated using the program contained on the 
diskette that was shipped with your DSS. 

To initialize the operating system for your VPU, place the INI- 
TIALIZATION diskette into drive A of the VPU (this diskette is 
the one shipped with your DSS). Be sure to insert the diskette 
properly with the notch on the upper edge and the labels away 
from the screen. Depress both RED keys simultaneously and load 
the initialization operating system. There will be three 
programs on the diskette that will generate your new operating 
system, depending on your VPU type. The programs are named 
MOD20DOS.COM, MOD30DOS.COM, and MODnODOS.C0M. Select the correct 
program for your VPU type. Type in the name and press the RETURN 
key. When asked for the source drive name, press the RETURN key. 
When asked for the destination drive name, type B. Then, when 
you have properly inserted a formatted diskette into drive B, 
press the RETURN key to inform the program that you are ready. 
Don't forget to push the diskette all the way in and lose the 
drive door. Press the RETURN key again when the function has 
completed and allow the operating system to reboot. 

The operating system contained on the diskette now in drive B 
will only work with a CompuStar DSS. Remove both diskettes from 
the VPU and turn the off the power. If any other VPUs are 
connected to the DSS network, make sure that the power is 
switched off on each of these. 

You are now ready to test the VPU and determine if it is able to 
communicate with the DSS. Press the POWER switch on the DSS, 
locking it in the ON position. The red ligh| on the POWER 
switch and the green light on the READY switch should come ,,on. 
Next, press the RESET switch in for for a few seconds. Now, turn 
on the power to the VPU being tested. If you have a Model 10 
VPU, the operating system should begin to load. If your VPU has 
its own disk drives, insert the diskette containing the network 
operating system into drive A. Depress both RED keys. The 
operating system should load. With all VPU models, the screen 
should contain the sign-on message in the upper portion of the 
screen. Also displayed should be the station number and the disk 
prompt. Reboot the operating system several times and make sure 
that it loads properly. 
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If the operating system fails to load, check the cable 
connections. Make certain that the station number has been 
correctly set on the, dipswitch located on the chaining adaptor 
board, and that no two stations have the same number setting. If 
you VPU has its own disk drives (Model 20, 30, or 40), be sure 
that the operating system was correctly copied. Repeat any steps 
as necessary. If the unit does not operate properly after you 
have checked everything, contact your Intertec representative. 

Once the VPU passes this step, switch the unit off before 
attaching any other units. Switch off the power to the DSS. 
Also, connect the next VPU and test it similarly. Do not test 
any VPU with the power on any other VPU. This way, you eliminate 
any potentially defective VPU. 
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SECTION 2.2 



2.2.0.0 PRACTICAL HINTS 

By now you should have read the CompuStar manual thoroughly, and 
you should be familiar with the hardware, operating system, and 
design scheme of your CompuStar Computer System. Next, we shall 
discuss some practical hints and little known facts that will 
help you become even more familiar with your computer system. 

2.2.1.0 LOGGING ONTO A DISK 

Each time you change a diskette, you must inform the operating 
system that you have done so. This prevents accidental alteration 
of disk contents because the operating system's copy of the 
directory does not agree with the files on the disk. Therefore, 
for devices with removable media, the directories are checked 
with each disk access. Each check produces a checksum , which is 
matched with the disk's last access. If these two sums do not 
match, then CP/M will not allow you to alter the diskette's 
contents. The disk is internally flagged READ ONLY, and an 
attempt to change anything on the diskette will produce the 
following error message: Bdos Err on d: R/0 , where 'd' is the 
drive in question. So when you change a diskette, you must per- 
form an operating system restart. The easiest way to do this is 
to hold down the 'control' key (marked CTRL), and then press the 
'C key. This will reload the operating system and will allow you 
to alter the newly inserted diskette. 

2.2.2.0 DISKETTE PRECAUTIONS 

Diskettes are a popular method of auxiliary storage for microcom- 
puter systems because of their size, price, and ease of use. 
There are some rules governing proper diskette care, and you 
should always be aware of these. 

1) Never allow anything to come in contact with the diskette 
surface. Never attempt to clean a diskette.. Although diskette 
exposure is limited to the access holes in the jacket, you should 
nevertheless be extremely careful when handling diskettes. Oils 
on your skin may make the diskette unreadable. 

2) Keep diskettes free from smoke or dust. This is best done by 
leaving diskettes in their protective covers. 

3) Keep magnetic objects away from diskettes as this may cause 
the contents of a diskette to be erased. Remember that tools 
often become magnetized. Transformers, power cords, and even 
telephones may emit magnetic radiation. 

4) Label your diskettes properly. When labels are attached to the 
jacket of a diskette, use only a felt-tipped pen to write on 
them. A pencil or ball-point pen may groove the diskette and 



make it unreadable. Place the 'WRITE PROTECT 1 strip over the 

notch of any diskette you do not want erased. Each box of 

Intertec diskettes comes with an ample supply of labels and 
aluminumized 'WRITE PROTECT' strips. 

5) Back up important diskettes by keeping separate copies of them 
in a safe place. Anticipate diskette failure because mistakes do 
happen. Place the date on duplicate copies so that you know how 
current their contents are. 

6) Diskettes can become damaged if exposed to temperature ex- 
tremes. 'Usually, a safe operating range is 50 to 120 degrees 
Farenheit. Humidity can also be important - 20 to 80 % relative 
humidity is suggested. Prolonged periods of sunshine can also 
damage a diskette's contents. 

7) Be sure to remove the diskette from the disk drive before 
the power is turned off the machine and return it to the 
protective jacket. 

8) Never rely upon a diskette that you suspect is damaged. Upon 
such suspicion, immediately copy its contents onto a newly 
formatted diskette, and then survey the damage. 

9) Remember that the FORMAT system program completely destroys 
the contents of a diskette. So does the command ERA *.*. The 
SYSGEN command will only affect the contents on the first two 
tracks (the operating system) of a diskette. 

10) IMPORTANT - The data contained on a diskette are always worth 
more than the diskette itself. Guard the data carefully. Heed 
these warnings. 



2.2.3.0 



CP/M SUMMARY 



Detailed operation of all CP/M programs can be found in other 
sections of this manual. Specifically, refer to Section 4, f AN 
INTRODUCTION TO CP/M 2.0 FEATURES AND FACILITIES' for the details 
on the use of the programs common to all CP/M systems, and see 
the section 'SOFTWARE ADDENDA' concerning the Intertec computers. 
Here we shall briefly summarize the system programs supplied on 
the Operating System Diskette for your CompuStar VPU, and CP/M's 
built-in functions. 



PROGRAM 
NAME 

PIP 

SYSGEN 

ED 



FUNCTION 

Copies files between devices, 
logical and physical. 

Generates a new operating 
system on diskette. 

Text Editor, allows changes 
to text files. 



EXAMPLE 

PIP B:=A:*.* 

PIP CON:=A:FILE.TYP 

SYSGEN 



ED PROGRAM. BAS 



ASM 



LOAD 



Assembles an 8080-type assembly 
language program into a 'HEX' file. 

Creates a 'memory image' file from 
a 'HEX' file that can be executed. 



ASM PROG 



LOAD PROG. HEX 



DDT 



Allows user to debug and step thru 
a 'COM' or 'HEX' file's execution. 



DDT PR0G.COM 
DDT PROG. HEX 



SUBMIT 



Performs sucessive execution of a 
list of 'COM' files. 



SUBMIT MORNING. SUB 



XSUB 



Forces data entry into a process 
under control of SUBMIT. 



XSUB 



DUMP 



STAT 



DIR 



Produces a hexadecimal listing 
of a disk file's contents. 



DUMP PR0G.COM 



Display or alter file status, device STAT B:*.* 
status, or system characteristics. STAT B:DSK: 



Displays a disk directory. 



DIR 
DIR B: 



ERA 
REN 
SAVE 



Erases a disk file. 

Renames a disk file. 

Save memory contents on the disk. 



ERA B-.PROG.BAK 

REN PR0G.ASM=PR0G.( 

SAVE 10 A. COM 



PROGRAM 
NAME 



FUNCTION 



EXAMPLE 



TYPE 

CONFIGUR 

FORMAT 

HEXDUMP 

64KTEST 
RX/TX 



Produces an ASCII listing 
of a disk file's contents. 

Establish operating system 
parameters. 

Place sector information on a 
new diskette. 

Generates a 'HEX* file from any 
file, and sends it out of a port. 

Performs extensive memory test. 



TYPE PROG.PRN 

CONFIGUR 

FORMAT 

HEXDUMP 

64KTEST 



Program pair to enable file transfer RX 
between two Stand-Alone VPUs . TX 



The reader should note that a CP/M program usually distributed 
with CP/M computer systems is not included with Intertec Computer 
Systems. The program, MOVCPM, allows the user to change the 
operating system for a number of memory sizes. However, all 
Intertec computer systems have only one memory size, and MOVCPM 
is not needed. Intertec furnishes operating system copies for 64K 
memory size. 

For a more complete discussion of these system programs, please 
refer either to these sections in this manual: AN INTRODUCTION TO 
CP/M FEATURES AND FACILITIES, CP/M 2.0 USER'S GUIDE FOR CP/M 1.4 
OWNERS, and SOFTWARE ADDENDA. 



2.2.4.0 AUTOLOAD FEATURE 

Perhaps you wish for your computer terminal to perform the same 
function upon each operating system restart. This is possible 
with CP/M version 2.2. The command buffer is the area in your 
computer's memory where the next command to be executed is 
placed. In normal CP/M systems this buffer is empty, and upon 
operating system restart the system awaits your command. You may 
alter this if desired, so that the system will execute any 
program on the disk upon restart. 

In order to facilitate this autoload feature, you have to change 
the operating system that is stored on the inner two tracks of 
your diskette. First, make a copy of the program on your distri- 
bution diskette that will generate the operating system. In the 
CompuStar Model 20, this program is called 'CS20DOS.COM 1 . Using 
the PIP program, copy as follows: 

PIP AUTOLOAD. COM=CS20DOS. COM 

CS20DOS.COM is similar to the SYSGEN utility, except that no 
SOURCE DRIVE is specified when using it. After you have made the 
c °py> y° u will have to alter its command buffer for the autoload 
capability. The DDT system program will have to be used to do 
this. It is strongly recommended that you become familiar with 
the DDT program before attempting to alter the operating system. 
See Section 7 of this manual, CP/M DYNAMIC DEBUGGING TOOL (DDT) 
USER'S GUIDE, for assistance. 

Next edit the program 'AUT0L0AD.COM' with the use of DDT. The 
correct command is: 

DDT AUT0L0AD.COM 

DDT will then load into the computer's memory and read in your 
'AUTOLOAD' program. After you have decided on the command you 
want to be executed upon restart, determine its length. This is 
done by counting the number of characters in the command. If a 
filename and/or parameters are included in the command, be sure 
to include their length(s) in the count. Also include any 
separating spaces. For example, if you wanted the directory 
display to be your command, the command is 'DIR', and its length 
is 3. If instead you wanted to sef a directory display of disk B, 
the command is 'DIR B: ♦ and its length is 6. 

The CP/M command buffer begins at location 980H. Use the 'S' 
command to alter the desired memory locations with your new 
command . Place the hexadecimal value of the command length in this 
location. The command itself begins at location 981H, and you 
may use up to location A07H for the buffer. Notice that if you go 
beyond location 998H, you will overwrite the copyright notice in 
the operating system. At the end of your command, place the null 
terminator 00H. When inserting the command itself into the 
memory locations, please note that you must enter hexadecimal 
numbers for the ASCII values of the letters in the command. The 



ASCII code chart is listed in Section 2.3 of this manual. 

When you have finished, use the DDT command 'D' to display the 
results of your action. Make any necessary corrections, and then 
exit to the operating system with the GO command. Before you do 
anything else, you must save the memory contents of the 'AUTO- 
LOAD 1 program. Using CP/M's 'SAVE' function, enter the following 
line at the keyboard: 

SAVE 48 AUT0L0AD.COM 

Let's review what we have done so far. First, we made a copy of 
the operating system, and called it 'AUT0L0AD.COM'. (Inci- 
dentally, any other name could have been used as long as the 
file type is '.COM'). Next, we placed a CP/M command into the 
CP/M command buffer, starting with the command length in hexa- 
decimal. We ended with a null byte terminator. Then we exited to 
the operating system and saved the revised program in memory on 
the disk. Now it is time to generate the new operating system. 

Please be sure that the command in the command buffer is what you 
want your computer to do upon each operating restart, because 
that is exactly what it will do. If sure, then type in the 
following command at the keyboard: 

AUTOLOAD 

From here the operation will be similar to that of the SYSGEN 
command. First you will be asked to enter a SOURCE DRIVE. Press 
the RETURN key here, the program itself is carrying the operating 
system for us. Next you will be asked to enter the DESTINATION 
DRIVE. Enter your choice, and press the RETURN key when the 
correct diskette has been inserted in the destination drive. If 
you are using a new diskette, make certain that it has been 
formatted with the FORMAT command. When the message 'FUNCTION 
COMPLETE' is displayed upon the screen, your transfer is done, 
and you should press the RETURN key to reboot the operating 
system. If you specified drive A as the destination drive, this 
reboot will incorporate your new modification. If not, replace 
the diskette in drive A with your destination diskette, and press 
both RED keys at the same time. You should now have an operating 
system with an autoload feature. If not, you probably incorrectly 
entered the command in the command buffer.. Repeat the above 
procedure if this is the case. 

WARNING: If you chose drive A as the destination drive and you 
made an error in altering the command buffer, this diskette will 
contain an unusable copy of the operating system. It will pro- 
bably not operate. You will have to replace its operating system 
with a valid copy probably using the 'SYSGEN' command. Therefore, 
it is recommended that you select drive B as your destination 
drive when altering the command buffer. 



Here is a sample session describing the steps needed to alter the 
command buffer of your operating system. Please carefully read 
the previous section before attempting to alter the command 
buffer. Note that all items underlined are to be typed in by you. 
Otherwise, the displays are generated by the computer. When you 
encounter ' (cr)', press the RETURN key. 

A>PIP22 AUTOLOAD. COM=CS20DOS. COME V] 



A>DDT AUT0L0AD.COM 
DDT VER 1.4 
NEXT PC 
3100 0100 

-S987 (cr) 
OWTWOo" (cr) 



0988 


20 


44 


(cr) 


0989 


20 


T*9 


(cr) 


098A 


20 


20 


(cr ) 


098B 


20 


42 


(cr) 


098C 


20 


3A 


(cr ) 


098D 


20 


00 


(cr) 


098E 


20 


. 


(cr) 


-GO 


(cr ) 





A> SAVE 48 AUT0L0AD.COM (cr) 

A> AUT0L0AD (cr) 

DESTINATION DRIVE NAME(0R RETURN TO REBOOT) B (cr) 

FUNCTION COMPLETE 

DESTINATION DRIVE NAME(0R RETURN TO REBOOT) (cr) 

A> 

(Now replace the diskette in drive B into drive A, and reboot) 



2.2.5.0 



PRINT SPOOLER OPERATION 



The CompuStar Computer System will employ a unique technique for 
print spooler operation. The spooler will use drive E in a 
CompuStar Network to facilitate printer operation. Further 
details will be released later. 



2.2.6.0 SYSTEM FAILURE 

Whenever you have a system failure, you should remain calm. Quite 
often, the results of a system failure are minimal. Failure 
recovery is important, and you should take all steps to insure 
that the system is restored as soon as possible. Use the follow- 
ing checklist as a guide and insure that each item is covered. If 
the system does not work after these items are checked, contact 
your Intertec representative. Note all failures in a log book so 
that you know what to suspect with subsequent failures. 

Check mechanical conditions: 

Is the unit plugged into a proper wall outlet? 

Is the power switch 'on'? 

Is the brightness knob on the back of the unit turned up? 

Are the cables properly connected and fastened tightly? 

Is the fuse blown? 

Operating System Problems: 

Is there a diskette in drive A? 

Is a valid copy of the operating system on the diskette in 
drive A? 

Have you incorrectly altered the DSS configuration? 

Have you carefully followed the restart instructions? 
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2.3 



VIDEO DISPLAY FEATURES 



All CompuStar Video Processing Units (except the Model 15) employ 
a 'memory-mapped' video scheme. This means that a portion of the 
central processing unit's memory is devoted to the characters for 
display on the screen. This memory area is unavailable for 
program or data use. The CRT Controller performs a direct memory 
access (DMA) cycle to obtain this data. This relieves the CPU of 
most screen-related functions. A more complete discussion of the 
video operation sequence can be found in Section 3-2 of this 
manual entitled 'THEORY OF OPERATION'. 

Memory-mapped video enables the VPU to provide powerful and fast 
video operation. This technique also permits many screen control 
features to be performed under software control. When the CRT 
Controller receives certain special inputs, the display may be 
affected. There are two main types of screen-directed inputs: 
'ESCAPE' sequences and 'CONTROL' sequences. An ESCAPE sequence 
means the ASCII character ESC (27H) is the first character of the 
input and is followed by other characters. A CONTROL sequence 
means that the CTRL key (third row of the keyboard, extreme left) 
is held down while the other character is depressed. The control 
key operates similarly to the SHIFT key. The following tables 
show the ESCAPE and CONTROL sequences and their interpretation by 
the video system. 



ESCAPE SEQUENCES 



[ESC] [Y] [row] 
[column] 



Absolute cursor addressing - The cursor is 
positioned to the row and column as 
specified in the screen layout chart. 
Refer to figure 2.3A for code translations 



[ESC] [~] [K] 



Erase to end of line - Data are erased 
from cursor position to the end of the 
line . 



[ESC] [~] [k] 



Erase to end of screen - Data are erased 
from cursor position to the end of the 
screen . 



[ESC] [~] [E] 



Display control characters - The trans- 
parent mode is enabled, and control 
characters received are displayed on the 
screen . 



[ESC] [~] [D] 



Disable control character display - The 
transparent mode is disabled, and control 
characters are not displayed. 



[ESC] [~] [B] Enable blinking display - All data 

received are displayed blinking. 

[ESC] [N] [B] Disable blinking display - turns off any 

blinking display. 

CONTROL SEQUENCES 

CTL-A Home cursor - The cursor is positioned 

at row 1 , column 1 . 

CTL-F Cursor forward - The cursor is moved one 

space to the right. 

CTL-H Cursor back - The cursor is moved one 

space to the left. 

CTL-K Cursor up - The cursor is positioned 

up to the previous line. 

CTL-J Cursor down - The cursor is positioned 

to the next line down. 

CTL-I Tabbing - The cursor is positioned to 

the next modulo-8 position. 

CTL-L Clear screen - Erases the data on the 

screen, and the cursor is homed. 

CTL-G Ring bell - The audio indicator is 

activated . 

CTL-W Page off/on - Video display is disabled/ 

enabled after the 24th line. 



SECTION 2.4 



2.4.1 SERIAL PORT INTERFACING INFORMATION 

In order to use auxiliary devices (sometimes called peripherals) 
with your CompuStar VPU, it is important to review the inter- 
facing information in this section. Each CompuStar VPU has two 
serial ports available for peripherals such as printers, modems, 
optical scanners, etc., and these are located on the back panel 
of the CompuStar adjacent to the power switch. These are marked 
MAIN PORT and AUXILIARY PORT. 

A port is simply a point of access to the computer system. The 
ports on a CompuStar VPU allow input or output, provided that the 
VPU and the peripheral device communicate properly. For proper 
protocol, simplified RS-232-C serial interface is provided. RS- 
232-C establishes the pin assignments on the port couplers for 
transmitted data, received data, handshaking, etc. 

Serial transmission refers to the way the data are transferred. 
Recall that internally the CompuStar manipulates data as bytes. 
Each byte is composed of eight bits, which may have a value of 
one or zero (these are numbers that the computer can read). If an 
entire byte of data were transmitted or received at one time, 
then the port would be a parallel port. The communication with 
the DSS is actually parallel. This is faster than serial communi- 
cation, but requires eight times as many communication lines for 
transmitting and receiving data as with serial protocol. So the 
CompuStar internally uses a device called a USART, or a Universal 
Synchronous/Asynchronous Receiver/Transmitter, which converts a 
byte of data into eight bits of data. The CPU sends the USART a 
byte, and the USART sends the coupler eight bits serially. At the 
other end, the coupler sends the USART eight bits serially, and 
the USART sends the computer one byte. 

Traditionally, in CP/M the printer is attached to the logical 
port designated as the list device. Logical just means that this 
is what the operating system calls the port. In the CompuStar, 
the LST: device is the same as the AUXILIARY PORT. Other devices 
which accept or transmit serial data can be attached to either 
port. CP/M refers to the MAIN PORT as the OUT:, PUN:, or RDR: 
device. You must write or otherwise obtain software needed to 
operate these devices. For a more complete discussion of CP/M's 
•logical devices', please refer to Section 4 of this manual - AN 
INTORDUCTION TO CP/M 2.0 FEATURES AND FACILITIES. 

Each port has two addresses associated with it - status and data. 
The following gives the port addresses internally for data and 
status transmission. When ready to accept data for transmission 
(i.e., out of the computer), the status byte will contain the 
hexadecimnal pattern 01H. When the port has received data for the 
computer and is ready to send it to the CPU, the status byte will 
contain 02H. Normally, the CPU will continuously check the 



status port until the desired number is present, and then the 
proper action will be taken accordingly. 

The memory address for the auxiliary port status is 4 1 H , and its 
data address is 40H. For the main port, the status address is 
59H, and the data address is 58H. The following assembly language 
program demonstrates how data might be transmitted out of a port. 



*************************************************** 

* * 

* 2.4.2 SAMPLE OUTPUT DRIVER PROGRAM * 

* * 

*************************************************** 



PRTOUT: ORG 
PDATA EQU 
PSTAT EQU 

LXI 
MVI 



LOOP 



LINE 



LDA 
ANI 
JNZ 
MOV 
OUT 
INX 
DCR 
JNZ 
RET 

DB 
END 



100H 

40H 

41H 

H,LINE 
C, 14 

PSTAT 

01H 

LOOP 

A,M 

PDATA 

H 

C 

LOOP 



'THIS IS A LINE' 



;base of TPA 
;address of AUX data 
;address of AUX status 

;HL <- address of text for output 
;C <- length of text 

get port status 
port ready to send? 
no, check again 
else load next byte of text 
send it out the port 
increment the text pointer 
and decrement the count 
continue if text remains 
else quit 



The reader is advised that alternate methods for input and/or 
output are available using the facilities of the CP/M operating 
system. Please review Section 9 of this Manual, CP/M 2.0 Inter- 
face Guide, for an explanation of such features. 



2.4.3 RS-232-C SERIAL INTERFACE 

The following chart illustrates the pinouts for the MAIN and 
AUXILIARY serial ports and the direction of signal flow. 

COMPUSTAR SERIAL PORT PIN ASSIGNMENTS 



MAIN 


PORT 




Pin 


# 


Assignment 


1 




GND 


2 




Transmitted Data 


3 




Received Data 


4 




Request to Send 


5 




Clear to Send 


6 




Data Set Ready 


7 




GND 


15 




Transmit Clock 


17 




Receive Clock 


20 




Data Terminal Ready 


22 




Ring Indicator 


24 




Clock 


AUXILIARY PORT 




Pin 


# 


Assignment 


1 




GND 


2 




Received Data 


3 




Transmitted Data 


7 




GND 


20 




Data Terminal Ready 



Signal Direction 

(From CompuStar 
(To CompuStar) 
(Fron CompuStar 
(To CompuStar) 
(To CompuStar) 

(To CompuStar) 
(To CompuStar) 
(From CompuStar 
(To CompuStar) 
(From CompuStar 



Signal Direction 

(To CompuStar) 
(From CompuStar 

(To CompuStar) 



2.4.4 ASYNCHRONOUS/SYNCHRONOUS COMMUNICATIONS 

The USART allows the serial data communication link to be either 
asynchronous or synchronous. With asynchronous operation, a 
start bit is sent to alert the receiver that a word is being 
transmitted. After the start bit, 5 to 8 data bits are sent. 
Subsequent to the data bits, an optional parity (or check) bit 
(representing an even number or odd number of '1' data bits) 
can be sent followed by 1, 1-1/2, or 2 stop bits. 

The following information for asynchornous communication may be 
programmed by the user: 

The number of data bits to be sent for each transmitted 
character (5 to 8) 

Odd or even parity or no parity bit for each transmitted 
character 

The number of stop bits to be sent for each transmitted 
character 

The rate at which characters are to be transmitted (1, 16, or 
64 times baud rate) 

For a synchronous communication link, the transmitted character 
will consist of 5 to 8 data bits plus an optional parity bit. 
Preceding the start of a transmitted data stream, the user can 
program one or two synchronization characters to be sent. These 
synchronization characters will only be used by the receiver in 
the internal synchronization mode. If the receiver is in the 
external synchronization mode, the synchronization characters 
will be ignored and a synchronization pulse is used. In the 
synchronous mode, the user may program the following: 

The number of bits per character (5 to 8) 

Optional parity bit (odd, even, or none) 

One or two synchronization characters and bit structure of 
characters 



External or internal synchronization 

Additional information concerning serial port interfacing 
(asynchronous and synchronous) is presented in sections 12 and 
13. 



2.5 SUPERBRAIN CHAINING ADAPTOR 

Via a special chaining adaptor, a SuperBrain or SuperBrain QD 
Video Computer Terminal may be connected to a CompuStar DSS. 
This will provide hard disk storage for a SuperBrain System. 
This section will instruct you concerning proper installation 
and configuration of a hard disk system. 

The chaining adaptor is shipped with a diskette. This diskette 
contains the program needed to allocate disk storage however you 
wish. Also contained on this diskette are the operations systems 
needed to allow the SuperBrain or SuperBrain QD to use the extra 
disk device--the standard DOS will not work. 

NOTE: Before proceeding, insure that the power cord is removed 
from the wall outlet. 

To attach the chaining adaptor to the SuperBrain, you must first 
remove the SuperBrain's cover. This is accomplished by removing 
the four screws holding the cover in place; two are in the 
front and two are in the rear. Make certain that the diskette 
drive doors are closed. Next, locate the short cable on the 
chaining adaptor. This will plug into the 40 pin connector at 
the top edge of the SuperBrain processor board located just 
beneath the disk drives. Be sure to align the notch in the 
connector with the slot on the processor board. Push the cable 
connector until it is completed seated. 

Insert the round end of the four mounting tabs into the four 
holes on the back of the disk assembly (see Figure 2.5A). Now 
place the board on the mounting tabs as shown in Figure 2.5B. Be 
careful that the cable does not come in contact with the fan. 
Then extend the long cable over the middle of the rear edge of 
the base. This cable will connect to the disk drive. 

Replace the cover on the SuperBrain, binding the long cable 
between the two cover halves. Replace the hold-down bolts to 
secure the attachment. 

Plug the connector on the end of the long cable into the re- 
ceptacle at the rear of the DSS. Tighten the connector screws 
making certain that the pins are in full contact. 

Now you may choose to change the disk allocations to other than 
factory configuration. This is suggested because disk space is 
lost due to CompuStar allocations for ten user stations. The 
process is fairly simple. Place the diskette included with the 
chaining adaptor in drive A of the SuperBrain. Be sure it is 
properly inserted with the notch on the upper edge and the 
labels facing away from the screen. Close the door to the disk- 
ette, and then simultaneously depress both RED keys. Now type 
the following line at the keyboard: 

SUBMIT22 SBGEN 



FIGURE 2.5A MOUNTING HOLES FOR SUPERBRAIN CHAINING ADAPTOR 



FIGURE 2.5B MOUNTED SUPERBRAIN CHAINING ADAPTOR 



A program on the diskete called SBGEN.SUB contains the names of 
the system programs needed to initialize the DSS. First, the 
DSS will be formatted. If you notice, the FAULT light on the DSS 
will come on during the formatting. This is normal, and does not 
indicate that anything is wrong. Do not reset the DSS until 
later . 

The DSS may have media errors on it. This means that some of the 
tracks on the disk may not be usable. Supplied with the DSS is a 
buff-colored card labeled 'SA1004 MEDIA ERROR MAP'. This card 
lists the media defects on the drive. 

It is necessary for you to enter the tracks and heads listed on 
the card so that these may be reassigned. Then, as the head 
positions itself at a defective track, it will reposition itself 
to an alternate track area. This makes the defective tracks 
transparent to the user. After you have entered all defective 
tracks, enter 'D' for a display of your entries for verification 
purposes. Then enter 'X' to exit the alternate track entry and 
proceed . 

There are approximately 8800 kilobytes (or 8.8 megabytes) of 
formatted disk area on the DSS. Enter allocations for drives C, 
D, and E. If you make invalid entries, you must reenter your 
choice. When finished, you are shown a summary of your entries. 
Don * t worry if the numbers are slightly greater than you 
entered; round-up occurs to insure boundary alignment. If you 
wish to change your entries, do so now by entering 'N' where 
asked. Otherwise, enter 'Y' . 

After you have made your entries, the initialization will 
complete a final task and return to the operating system. One 
more step is needed to complete the process. You must have a 
different operating system on the diskette to use the DSS. The 
standard SuperBrain or SuperBrain QD operating system will not 
work. You must place a copy of the new operating system on 
another formatted diskette. 

These operating systems are on the diskette in drive A. Enter 
'SB10MDOS' to copy the operating system for a SuperBrain, or 
'QD10MDOS' for the SuperBrain QD. The program will ask you for 
the source drive. Press return here. Then you will be asked for 
a destination drive. Here, press the 'B' key. Press the 
'RETURN' key when you have placed a formatted diskette into drive 
B. When the program displays 'FUNCTION COMPLETE', press the 
'RETURN' key. 

After the new operating system has been placed on the diskette in 
drive B, you are ready to test it. First, press the RESET button 
on the DSS, and the FAULT light should go out. Then exchange 
the two diskettes in drives A and B. Then depress both RED keys 
simultaneously. This will load in the newly generated operating 
system. If the screen fills with garbled text, you have im- 
properly copied the operating system, and you should repeat the 
last step. Otherwise, enjoy your new, powerful computer. 
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3.1 SYSTEM INFORMATION 

The CompuStar Video Processing System (VPU) represents the latest 
technological advances in the microprocessor industry. The 
universal adaptability of its CP/M* Disk Operating System 
satisfies the general purpose requirement for a low cost, high 
performance microcomputer system. 

The price/performance ratio of the CompuStar has rarely been 
equalled in this industry. By employing innovative design tech- 
niques, the system is not only able to offer a competitive price 
advantage, but boasts many features found only in systems costing 
three to five times as much. The twin Z80A microprocessors in 
each CompuStar VPU insure extremely fast program execution even 
when faced with the most difficult programming tasks. In 
addition, each unit must pass a grueling M8 hour burn-in before 
it is shipped to the Customer. By combining advanced 
microprocessor technology with in-house manufacturing capability 
and stringent quality control requirements, your CompuStar System 
should provide unparalleled reliability in any application into 
which it is passed. 

3.1.1 THE COMPUSTAR VPU AND DSS 

The CompuStar Multi-User System consists of a network of video 
display terminals (called video processing units) which employ 
their own internal microprocessor and dynamic RAM. The ter- 
minals are tied toget-her in a network fashion to "share" the 
resources of a single Winchester or other hard disk device. In 
this manner, the CompuStar allows true multi-user capability by 
permitting the sharing of a common data base while at the same 
time allowing individual users the capability to maintain re- 
stricted data bases. 

A CompuStar system can be configured using any one of three disk 
storage devices (called Disk Storage Systems — DSS), all of which 
are manufactured by Intertec. A DSS consists of a hard disk 
device, complete with power supply and Intertec's special disk 
controller and multiplex circuitry to tie users' stations into a 
common disk. The three DSS models available include a table top 
ten megabyte Winchester model and Control Data Corporation's 32 
or 96 megabyte cartridge module drive models. The CDC drives 
feature a 16 megabyte removable, top loading platter and either 
16 or 80 megabytes fixed disk storage. 

A series of 4 types of video processing units (VPU's) can be 
connected into a disk storage system. The VPU's connect by an 8 
bit parallel interface, thus allowing a data transfer rate of 1.6 
million WPS between the disk storage system and the terminals. 
In this manner, the distance over which signals can be transfered 
(from disk system to terminal station) is significant. . . .up to 
one mile in total cable length. And since premanuf actured cable 
assemblies (with 37 pin 'D'-type connectors on each end) are 
offered in a variety of lengths, installation of a CompuStar 
network is a real snap! 



The video processing units are connected in a "daisy chain" 
fashion; i.e., the first terminal is connected directly into the 
CompuStar disk storage system, the second terminal is connected 
into the first, the third into the second, and so on. A total of 
up to 255 video processing units can be connected into a single 
network. Each VPU is assigned a variable address via an 8 posi- 
tion dipswitch mounted internally. This allows each terminal 
access to the common and/or restricted data base on the disk 
storage system. Plus, each terminal has twin RS-232 Serial Ports 
for connecting auxiliary printer and/or modem devices. 

From the standpoint of human engineering, each CompuStar VPU has 
been designed to minimize operator fatigue through the use of a 
typewriter-oriented keyboard and a remarkably clear display. 
Each video processing unit displays a total of 1,920 characters 
arranged in 24 lines with 80 characters per line. The video 
display is unusually crisp and sharp due to Intertec's own 
specially designed video driver circuitry. And, the high 
quality, non-glare etched CRT featured on every VPU assures ease 
of viewing and uniformity of brightness throughout the entire 
screen. 

The CompuStar*s unique internal design assures users of 
exceptional performance for just a fraction of what they would 
expect to pay for such "big system" capabilities. The CompuStar 
VPU utilizes a single board "microprocessor" design which 
combines all processor,. RAM, ROM, disk controller, and 
communications electronics on the same printed circuit board. 
This type of design engineering enables the CompuStar to deliver 
superior, competitive performance. 

Standard features of the CompuStar Model 20 VPU includes: two 
double-density, single-sided mini-floppies with a total of over 
350,000 bytes formatted disk storage, 64K of dynamic RAM memory, 
a universally recognized CP/M* Disk Operating System featuring 
its own text editor, an assembler for assembly language 
programming, a program debugger and a disk formatter. Also 
standard are dual universal RS-232 communications ports for 
serial data transmission between a host computer network via 
modem or an auxiliary serial printer. A number of transmission 
rates up to 9600 baud are available and selectable under program 
control . 

The Model 30 VPU incorporates these same features, but boasts 
nearly 750,000 bytes of disk storage units, twin double-density, 
double-sided drive mechanism. The Model 40 employs dual double- 
track drive assemblies to provide the user with nearly 1-1/2 
million bytes of local, off-line storage capability. 



For reliability, each CompuStar VPU has been designed around 
modules packaged in an aesthetically pleasing desk-top unit. 
These major components are: the Keyboard/CPU module, the power 
supply module, the CRT assembly, the chaining adaptor and the 
disk drives themselves. Failure of any component within the 
terminal may be corrected by simply replacing only the defective 
module. Individual modules are fastened to the chassis in such a 
manner to facilitate easy removal and reinstallation. Terminal 
down-time can be greatly minimized by simply "swapping-out" one 
of the modules and having component level repair performed at one 
of Intertec f s Service Centers. Spare modules may be purchased 
from an Intertec marketing office to support those customers who 
maintain their own "in-house" repair facilities. 

CompuStar VPU cover assembly is exclusively manufactured "in- 
house" by Intertec. A high-impact, structural-foam material is 
covered with a special "felt-like" paint to enhance the overall 
appearance. Since the cover assembly is in jected-molded , there 
is virtually no possibility of cracks and disfigurations in the 
cover itself. And, by manufacturing and finishing the cover 
assembly in-house, Intertec is able to specify only high quality 
material on the external and internal cover components of your 
CompuStar to insure unparalleled durability over the years to 
come . 



3.1.2 SOFTWARE AND OPTIONS 

A wide variety of programming tools and options are either 
planned or available for the CompuStar System. Standard software 
development tools available from Intertec include Basic, Fortran 
and Cobol programming languages. A wide variety of applications 
packages (general ledger, acounts receivable, payroll, inventory, 
word processing, etc.) are available to operate under the 
CompuStar CP/M Disk Operating System from leading software ven- 
dors in the industry. 



CUTAWAY VIEW SHOWING MOUNTING OF MAJOR SUBASSEMBLIES 



3.2 THEORY OF OPERATION 

The CompuStar contains two Z80 microprocessors. (Reference 
Figure 3.1) uP1 is the master processor. It communicates with 
the 64K RAM and the I/O devices (serial port, keyboard encoder, 
interface controller, and CRT controller). Aside from these 
devices, it can also access the 2K ROM and DATA BUFFER RAM in the 
FLOPPY DISK CONTROLLER. uP2 is slaved to uP1 and can only access 
the 2K ROM, DATA BUFFER, and the DISK INTERFACE. This processor 
is used exclusively for disk control. 

The 64 kilobyte main memory consists of thirty-two 16K x 1 bit 
dynamic RAMS. These are divided in four banks (0-3) with each 
bank containing 16 kilobytes of storage. The RAS-CAS timing 
sequence necessary for memory access is created by the memory 
timing generator. 

There are two devices that can access memory--uP1 and the CRT 

Controller. uP1 can read and write to memory while the CRT 

Controller can only perform the read function. Because each 

device runs at a different speed, two clock frequencies are 

required for memory timing. The speed is determined by the 

selection of the control input to the timing generator. The 
microprocessor functions require the faster clock. 

The CRT-VIDEO CONTROLLER contains three main devices — the CRT 
Controller which generates all the timing signals for data 
display; the video generator which produces the character font; 
and the octal 80-bit shift register which stores one row of video 
data. (80 characters) 

The CRT Controller generates all the timing necessary to display 
24 rows of characters with 80 characters per row. Thus, the 
screen can display a total of 1920 characters. These characters 
are stored in the CRT refresh buffer which is the upper 2048 
bytes (2K) of RAM. 

Because the CRT buffer is not a separate buffer and the processor 
must also use the same bus to access memory, this bus must be 
timeshared between the two. This is accomplished by the CRT 
controller performing a direct memory access (DMA) cycle which is 
done at the beginning of each scan row. Each scan row is divided 
into ten scan lines, therefore during the first scan line time, 
the controller takes control of the processor bus by generating a 
bus request. After acquiring the bus, it reads 80 characters 
from the CRT buffer and loads them into the 80 x 8 shift 
register. This data is then recirculated in the buffer for the 
next nine scan lines to produce one row of video characters. 
Therefore, there are twenty-four DMA cycles performed per 
vertical frame. 

There are also twenty-five interrupts generated--one for each row 
scan and one extra during vertical blanking. During the first 



twenty-four, the processor sets or resets the video blanking 
depending on whether that row is displayed or not. During the 
vertical blanking interrupt, the address registers in the CRT 
controller are initialized to the correct top-of-page address and 
the cursor register is also updated. 

The Interface Controller is basically three 8 bit I/O ports 
(8255). Through this device, the processor can obtain status 
bits from other devices and react to the status by 
setting/resetting individual bits in the 8255. 

The Keyboard Encoder scans the keyboard for a key depression, 
determines its position, and generates the correct ASCII code for 
the key. The processor is flagged by the 'Data Ready' signal via 
the Interface Controller. The character is then input by the 
processor . 

The Chaining Adaptor Module provides a high speed interface 
between each CompuStar VPU and the Disk Storage System (DSS). 
Its function is to provide a point of access bus for each VPU in 
the CompuStar Computer Network. 

The CompuStar bus is a parallel bi-directional bus with 12 
differently driven, TTL signals. The information communicated on 
the bus includes data and control signals. The bus has been 
constructed to allow approximately 4000 feet of cable to be used 
in a single CompuStar System (up to 255 Video Processing 
Systems) . 

The remaining I/O device is the RS-232-C Serial Interface Port. 
Presently, it operates only in the asynchronous mode and adheres 
to a simplified standard protocol. The baud rate is set to 1200 
baud by the operating system. (Refer to the Technical Bulletin 
enclosed at the end of this manual.) 

As previously mentioned, uP1 has the capability of communicating 
with the RAM and ROM in the FLOPPY DISK CONTROLLER. It does this 
to obtain the bootloader from ROM on power-up and system reset 
and also when transferring disk parameters and data to/from the 
Data Buffer RAM. Because the amount of main memory used is the 
maximum that the processor addressing can support, different 16K 
banks of main memory must be switched off line when communicating 
with the disk RAM or ROM. In these cases, Bank (0000H-3FFH) is 
switched out when communicating with the ROM, and Bank 2 (8000H- 
BFFFH) when communicating with the RAM. 

The DISK CONTROLLER performs all disk related I/O functions upon 
command from the main processor. These commands are: 

Restore to track 

Read sector 

Write sector 

Write sector with deleted data mark 

Format 



The parameters associated with drive, side, track and sector 
numbers are loaded, a status word is set at specified location in 
the disk RAM. When uP2 receives this status, it sets the 'disk 
busy' status bit and performs the indicated function. Upon com- 
pletion, it resets the 'busy* bit thus allowing the main 
processor (uP1) to retrieve data and status from the RAM. 



SECTION 3.3 VIDEO PROCESSING UNIT SPECIFICATIONS 

FEATURE DESCRIPTION 

CPU 

Microprocessors Twin Z80A's with 4MHZ Clock Frequency. 

One Z80A (the host processor) performs 
all processor and screen related 
functions. The second Z80A is "down- 
loaded" by the host to execute disk I/O. 

Word Size 8 bits 

Execution Time 1.0 microseconds 

Machine Instructions 158 

Interrupt Mode All interrupts are vectored and reserved 

Floppy Disk 

Storage Capacity Over 350K (700K Model 30; 1400K Model 

(For Models 20, 40) unformatted data on two 5-1/4" mini- 

30, 40) drives. External hard disk storage can 

be connected using the chaining adaptor. 

Format Soft sectored; 512 bytes/sector; 10 

sectors/track; 35/70/140 tracks per 
diskette (for Model 20/30/40). 

Data Transfer Rate 250K bits/second 

Average Access Time 250 milliseconds. 35 milliseconds track- 
to-track 

Media 5-1/4 inch mini-disk 

Disk Rotation 300 RPM 

Internal Memory 

Dynamic RAM 64K 

Static RAM 1K bytes of static RAM is provided in 

addition to the main processor RAM. 
This memory is used for program and/or 
data storage for the auxiliary processor 

ROM Storage 2K bytes standard. Allows ROM "boot- 

strapping" of system at power-on. 

CRT 

Display Size 12-inch, P4 phosphor 

Display Format 24 lines x 80 characters per line 



FEATURE 



DESCRIPTION 



Character Font 

Display Presentation 

Bandwidth 

Cursor 

Communications 

Screen Data Transfer 

Main Interface 

Auxiliary Interface 
Chaining Interface 

Z80A Data Bus 
Parity 

Transmission Mode 

Addressable Cursor 

System Utilities 

Disk Operating System 

DOS Software 



Optional Software 
FORTRAN 



COBOL 



BASIC 



Application Packages 



5x7 character matrix on a 7 x 10 
character field 

Light characters on a dark background 

15 MHZ 

Reversed image (block cursor) 



Memory-mapped at 38 kilobaud. Serial 
transmission of data at rates up to 9600 
bps . 

RS-232C asynchronous. Synchronous 
interface internally selectable. 

Simplified RS-232C asynchronous. 

Intertec protocol — used for daisy- 
chaining multiple users into a single 
disk network. 

40-pin Data Bus connector 

Choice of even, odd, marking, or 
spacing — under program control. 

Half or Full Duplex. 1, 1 1/2, or 2 stop 
bits 

Direct Positioning by absolute x, y 
addressing . 

CP/M 2.2 

An 8080 disk assembler, debugger, text 
editor and file handling utilities. 



ANSI standard. Relocatable, random and 
sequential disk access. 

ANSI standard. Relocatable, sequential, 
relative and indexed disk access. 

Sequential and random disk access. Full 
string manipulation, interpreter. 

Extensive software development tools are 
available from leading software vendors 
including software for the following ap- 
plications : Payroll , Accounts Receivable, 



FEATURE 



DESCRIPTION 



Application Packages 
(continued) 

Keyboard 

Alphanumeric 
Character Set 

Special Features 



Numeric Pad 



Cursor Control Keys 

Internal Construction 
Cabinetry 

Component Layout 



Mounting 

Environment 
Weight 

Physical Dimensions 

Environment 

Power Requirements 



Accounts Payable, Inventory Control, 
General Ledger, and Word Processing. 



Generates all 128 upper and lower case 
ASCII characters. 

2-Key Rollover, Keyboard lock/unlock — 
under program control. 

0-9, decimal point, comma, minus and 
user-programmable function keys. 

Up, down, forward and backward. 



Structural foam. 

Four board modular design. All 
processor related functions and hardware 
are on a single printed circuit board. 
All video and power related circuits on 
separate single boards. 

All modules mounted to base. CRT in a 
rigid aluminum frame. Disk Drive 
assemblies are mounted into special 
bracket for ease of servicing. 



Approximately 45 pounds. 

14-5/8" (H) x 21-3/8" (W) x 23-1/8 (D) 

Operating: to 40 C Storage: to 
85 C; 10 to 85% rel. humidity - non- 
condensing. 

115 VAC, 60 HZ, 3 AMP (optional 230VAC/ 
5HHZ model available). 

*Specif ications subject to change with- 
out notice. 



3.3.1 COMPUSTAR VPU INTERNAL CONSTRUCTION 

Perhaps the most remarkable feature of the CompuStar VPU is its 
modular construction using only four major subassemblies which 
are clearly defined in their respective functions so as to 
facilitate ease of construction and repair. These four subassem- 
blies are shown in figure 1 and described below. 



Disk Drive Module (not on Model 10) 
CRT Display Module 



Chaining Adaptor 



Main Power Supply I/O Module 



Keyboard/CPU Module 



3.3.2 KEYBOARD/CPU MODULE 

The control section of the CompuStar VPU is based upon the widely 
acclaimed Z80A microprocessor. The result is far fewer 
components and the ability to perform a number of functions not 
possible with any other approach. The Keyboard/CPU module 
(figure two) contains the twin Z80 microprocessors. One Z80A 
(the host processor) performs all processor and screen related 
functions while the second Z80A can be "downloaded" to execute 
disk I/O handling routines. The result is extremely fast execu- 
tion time for even the most sophisticated programs. 

In addition to containing the VPU's microprocessor circuitry, 
the Keyboard/CPU module contains 64K of dynamic RAM (see figure 
3). Also found on this module is: the character and keyboard 
encoder circuitry, the "bootstrap" ROM, the disk contoller and 
all communications electronics. Power is supplied to and signals 
are transferred from this module via a single 22 pin ribbon cable 
connected to the main power supply module. Connection of this 
module to the disk drive subassemblies is via a separate ribbon 
cable. Figure 4 shows the connectors on the Keyboard/CPU module 
which are used for interconnecting this module with the disk 
drive subassemblies, the main power supply and the chaining 
adaptors . 



Figure 2 - CompuStar Keyboard/CPU Module 



Figure 3 - Dynamic RAM Section Figure 4 - Keyboard/CPU 
Every CompuStar is equipped with Module Connectors 

64 K dynamic RAM The 40 pin connector on the 

top edge of the card is for 
connection to the CompuStar 
chaining adaptor. The 40 
pin connector on the right 
edge routes signals to and 
from the disk drive assem- 
bly. 



3.3.3 CRT DISPLAY MODULE 

The CRT Display Module consists of a 12-inch, high resolution, 
cathode ray tube mounted in a rigid aluminum chassis. The 
faceplate of the CRT is etched in order to reduce glare on the 
surface of the screen and provide uniform brightness throughout 
the entire screen area. The CRT display presentation is arranged 
in 24 lines of 80 characters per line. 

The CRT video driver circuitry is mounted in the base of the CRT 
chassis to facilitate ease of removal and subsequent repair. In 
this manner, either the CRT itself or the video circuitry can be 
easily exhanged without disrupting any of the other major modules 
within the terminal (see Figure 5). 



Figure 5 - CRT Display Module 
This module is easily removed for service or replacement. 
A single edge connector is provided for connection to 
the VPU's Power Supply Mode. 



3.3.4 POWER SUPPLY MODE 

The CompuStar power supply is a "solid-state, switching" design 
and employs switching voltage regulators to provide many years of 
trouble-free service. This design reduces heat dissipation and 
allows for efficient cooling of the entire terminal with a 
specially designed whisper fan to reduce environment noise. The 
entire power supply can be easily removed by unscrewing the three 
screws holding it into the base of the terminal. Included on the 
power supply module are the power off /on switch, the user 
brightness control, the main and auxiliary RS232 serial ports and 
the chaining adaptor circuitry (and connectors) which allow 
multi-users to be connected into a single Disk Storage System. 
By combining the power supply section and external serial 
communiations connections on the same module, the total module 
count is able to be kept to a minimum thus greatly faciltating 
ease of field service repair while at the same time minimizing 
the number of modules required to be stocked to effect competent 
field repair (refer to figure six). 



Figure 6 - Power Supply Module 
with Chaining Adapter card installed 



3.3.5 DISK DRIVE MODULES FOR MODELS 20, 30 AND 40 VPU's ONLY 

Figures 7 and 8 illustrate the left and right views of the 
specially designed double-density disk drive subassembly. The 
Model 20, 30 and 40 VPU's contain two of these type drives which 
are mounted conveniently just to the right of the CRT display 
module on a rugged aluminum mounting bracket which supports the 
drives so that they are flush mounted with the front "bezel" of 
the unit. Power to thefse drives is derived from the Power 
Supply Module located just behind the drive assemblies 
themselves. Data to and from these drives is routed via a single 
34 pin ribbon cable connecting the drives to the Keyboard/CPU 
module. 



Figure 7 - Top View of CompuStar 
(Not applicable for Model 10) 



Figure 8 - Bottom View of CompuStar Drive Assembly 
(Not applicable for Model 10) 



3.4 10 MEGABYTE DISK STORAGE SYSTEM SPECIFICATIONS 



Performance Specifications 

Capacity SA1004 

Unformatted 

Per Drive 10.67 Mbytes 

Per Surface 2.67 Mbytes 

per Track 10.4 Kbytes 

Formatted 

Per Drive 

Per Surface 

Per Track 

Per Sector 

Sectors/Track 
Transfer Rate 
Access Time 

Track to Track 

Average 

Maximum 
Average Latency 

Functional Specifications 

Rotational Speed 

Recording Density 

Flux Density 

Track Density 

Cylinders 

Tracks 

R/W Heads 

Disks 

Index 

Physical Specifications 

Environmental Limits 

Ambient Temperature = 50 to 115 F(10 to 46 C) 

Relative Humidity = $% to 80% 

Maximum Wet Bulb = 78% non-condensing 

AC Power Requirements 
50/60 Hz 0.5 hz 

100/115 VAC Installations = 90-127V at 1.1A typical 
200/230 VAC Installations = 180-253V at 0.6A typical 

DC Voltage Requirements 

+24 VDC + 10% 2.8A typical during stepping 

(0.2A typical steady state) 
+5 VDC + 5% 3.6A typical 
-5 VDC + 5% (-7 to -16 VDC optional) . 2A typical 



8.4 


Mbytes 


2.1 


Mbytes 


8.2 


Mbytes 


256 


Kbytes 




32 


4.34 I 


Mbits/sec 


19 i 


msec 


70 i 


msec 


150 i 


msec 


9.6 i 


msec 


3125 


rpm 


6270 


bpi 


6270 


fci 


172 


tpi 


256 


1024 


4 




2 




1 





Mechanical Dimensions 

Rack Mount Standard Mount 

Height = 4.62 in. (117.3mm) 4.62 in. (117.3mm) 

Width = 8.55 in. (217.2mm) 9.50 in. (241.3mm) 

Depth = 14.25 in. (362.0mm) 14.25 in. (362.0mm) 
Weight = 17 lbs. (7.7Kg) 17 lbs. (7.7kg) 

Heat Dissipation = 511 BTU/Hr. typical (150 Watts) 

Reliability Specifications 

MTBF: 8,000 POH typical usage 
PM : Not Required 
MTTR: 30 minutes 
Component Life: 5 Years 

Error Rates: 

Soft Read Errors: 1 per 10 bits read 

Hard Read Errors: 1 per 10 bits read 

Seek Errors: 1 per 10 seeks 



3.4.1 10 MEGABYTE DISK STORAGE SYSTEM INTERNAL CONSTRUCTION 

The 10 Megabyte DSS contains the typical high quality modular 
construction of other Intertec products. Ease of servicing and 
rugged reliability have been built into each component. 

Featured below are the main modules of the 10 megabyte DSS. 
Figure A illustrates the +5 volt and +12 volt supply and Figure B 
represents the +24 volt supply. 

The Disk Drive Assembly is shown in Figure C. This assembly 
contains the motors, read/write heads, electronic board, and 
enclosed recording media. 

The chassis assembly with cooling fan in shown in figure D. 

Figure A Figure B Figure C Figure D 



5, +12 Volt +24 Volt Power Disk Drive Chassis Assembl 

Power Supply Supply Module Assembly 

Module 



3.4.2 32 MEGABYTE DISK STORAGE SYSTEM INTERNAL CONSTRUCTION 
(To Be Added) 



3.4.3 96 MEGABYTE DISK STORAGE SYSTEM INTERNAL CONSTRUCTION 
(To Be Added) 
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1. INTRODUCTION. 

CP/M is a monitor control program for microcomputer system development 
which uses IBM-compatible flexible disks for backup storage. Using a computer 
mainframe based upon Intel's 8080 microcomputer, CP/M provides a general 
environment for program construction, storage, and editing, along with 
assembly and program check-out facilities. An important feature of CP/M is 
that it can be easily altered to execute with any computer configuration which 
uses an Intel 8080 (or Ziloq Z-80) Central Processing Unit, and has at least 
16K bytes of main memory with up to four IBM-compatible diskette drives. A 
detailed discussion of the modifications required for any particular hardware 
environment is given in the Digital Research document entitled "CP/M System 
Alteration Guide." Although the standard Digital Research version operates on 
a single-density Intel MDS 800, several different hardware manufacturers 
support their own input-output drivers for CP/M. 

The CP/M monitor provides rapid access to programs through a 
comprehensive file management package. The file subsystem supports a named 
file structure, allowing dynamic allocation of file space as well as 
sequential and random file access. Using this file system, a large number of 
distinct programs can be stored in both source and machine executable form. 

CP/M also supports a powerful context editor, Intel-compatible assembler, 
and debugger subsystems. Optional software includes a powerful 
Intel-compatible macro assembler, symbolic debugger, along with various 
high-level languages. When coupled with CP/M's Console Command Processor, the 
resulting facilities equal or excel similar large computer facilities. 

CP/M is logically divided into several distinct parts: 

BIOS Basic I/O System (hardware dependent) 

BDOS Basic Disk Operating System 

CCP Console Command Processor 

TPA Transient Program Area 

The BIOS provides the primitive operations necessary to access the 
diskette drives and to interface standard peripherals (teletype, CRT, Paper 
Tape Reader/Punch, and user-defined peripherals) , and can be tailored by the 
user for any particular hardware environment by "patching" this portion of 
CP/M. The BDOS provides disk management by controlling one or more disk 
drives containing independent file directories. The BDOS implements disk 
allocation strategies which provide fully dynamic file construction while 
minimizing head movement across the disk during access. Any particular file 
may contain any number of records, not exceeding the size of any single disk. 
In a standard CP/M system, each disk can contain up to 64 distinct files. The 



BDOS has entry points which include the following primitive operations which 
can be pr ©grammatically accessed: 

SEARCH Look for a particular disk file by name. 

OPEN Open a file for further operations. 

CLOSE Close a file after processing. 

RENAME Change the name of a particular file. 

READ Read a record from a particular file. 

WRITE Write a record onto the disk. 

SELECT Select a particular disk drive for further 
operations. 

The CCP provides symbolic interface between the user's console and the 
remainder of the CP/M system. The CCP reads the console device and processes 
commands which include listing the file directory, printing the contents of 
files, and controlling the operation of transient programs, such as 
assemblers, editors, and debuggers. The standard commands which are available 
in the CCP are listed in a following section. 

The last segment of CP/M is the area called the Transient Program Area 
(TPA) . The TPA holds programs which are loaded from the disk under command of 
the CCP. During program editing, for example, the TPA holds the CP/M text 
editor machine code and data areas. Similarly, programs created under CP/M 
can be checked out by loading and executing these programs in the TPA. 

It should be mentioned that any or all of the CP/M component subsystems 
can be "overlayed" by an executing program. That is, once a user's program is 
loaded into the TPA, the CCP, BDOS, and BIOS areas can be used as the 
program's data area. A "bootstrap" loader is pr ©grammatically accessible 
whenever the BIOS portion is not overlayed; thus, the user program need only 
branch to the bootstrap loader at the end of execution, and the complete CP/M 
monitor is reloaded from disk. 

It should be reiterated that the CP/M operating system is partitioned 
into distinct modules, including the BIOS portion which defines the hardware 
environment in which CP/M is executing. Thus, the standard system can be 
easily modified to any non-standard environment by changing the peripheral 
drivers to handle the custom system. 



2. FUNCTIONAL DESCRIPTION OF CP/M. 

The user interacts with CP/M primarily through the CCP, which reads and 
interprets commands entered through the console. In general, the CCP 
addresses one of several disks which are online (the standard system addresses 
up to four different disk drives). These disk drives are labelled A, B, C, 
and D. A disk is "logged in" if the CCP is currently addressing the disk. In 
order to clearly indicate which disk is the currently logged disk, the CCP 
always prompts the operator with the disk name followed by the symbol ">" 
indicating that the CCP is ready for another command. Upon initial start up, 
the CP/M system is brought in from disk A, and the CCP displays the message 

xxK CP/M VER m.m 

where xx is the memory size (in kilobytes) which this CP/M system manages, and 
m.m is the CP/M version number. All CP/M systems are initially set to operate 
in a 16K memory space, but can be easily reconfigured to fit any memory size 
on the host system (see the MDVCPM transient command) . Following system 
signon, CP/M automatically logs in disk A, prompts the user with the symbol 
,, A>" (indicating that CP/M is currently addressing disk "A") , and waits for a 
command. The commands are implemented at two levels: built-in commands and 
transient commands. 

2.1. GENERAL OOMMAND STRUCTURE. 

Built-in commands are a part of the CCP program itself, while transient 
commands are loaded into the TPA from disk and executed. The built-in 
commands are 

ERA Erase specified files. 

DIR List file names in the directory. 

REN Rename the specified file. 

SAVE Save memory contents in a file. 

TYPE Type the contents of a file on the logged disk. 

Nearly all of the commands reference a particular file or group of files. The 
form of a file reference is specified below. 

2.2. FILE REFERENCES. 

A file reference identifies a particular file or group of files on a 
particular disk attached to CP/M. These file references can be either 
"unambiguous" (ufn) or "ambiguous" (afn) . An unambiguous file reference 
uniquely identifies a single file, while an ambiguous file reference may be 



satisfied by a number of different files. 

File references consist of two parts: the primary name and the secondary 
name. Although the secondary name is optional, it usually is generic; that 
is, the secondary name "ASM," for example, is used to denote that the file is 
an assembly language source file, while the primary name distinguishes each 
particular source file. The two names are separated by a "." as shown below: 

PPPPPPPP.sss 

where pppppppp represents the primary name of eight characters or less, and 
sss is the secondary name of no more than three characters. As mentioned 
above, the name 

PPPPPPPP 

is also allowed and is equivalent to a secondary name consisting of three 
blanks. The characters used in specifying an unambiguous file reference 
cannot contain any of the special characters 

<>.,;:=?*[] 
while all alphanumerics and remaining special characters are allowed. 

An ambiguous file reference is used for directory search and pattern 
matching. The form of an ambiguous file reference is similar to an 
unambiguous reference, except the symbol "?" may be interspersed throughout 
the primary and secondary names. In various commands throughout CP/M, the "?" 
symbol matches any character of a file name in the "?" position. Thus, the 
ambiguous reference 

X?Z.C?M 

is satisfied by the unambiguous file names 

XYZ.COM 
and 

X3Z.CAM 

Note that the ambiguous reference 
* * 

is equivalent to the ambiguous file reference 
wo'?'?'?'?'? '?•?'? 

while 



pppppppp.* 
and 

*.sss 

are abbreviations for 

PPPPPPPP.??? 
and 

????????. sss 

respectively. As an example, 

DIR *.* 

is interpreted by the CCP as a command to list the names of all disk files in 
the directory, while 

DIR X.Y 

searches only for a file by the name X.Y Similarly, the command 

DIR X?Y.C?M 

causes a search for all (unambiguous) file names on the disk which satisfy 
this ambiguous reference. 

The following file names are valid unambiguous file references: 

X XYZ GAMMA 

X.Y XYZ. COM GAMMA.l 

As an added convenience, the programmer can generally specify the disk 
drive name along with the file name. In this case, the drive name is given as 
a letter A through Z followed by a colon (:). The specified drive is then 
"logged in" before the file operation occurs. Thus, the following are valid 
file names with disk name prefixes: 

A:X.Y B:XYZ C:GAMMA 

Z:XYZ.GOM B:X.A?M C:*.ASM 

It should also be noted that all alphabetic lower case letters in file 
and drive names are always translated to upper case when they are processed by 
the CCP. 



3. SWITCHING DISKS. 

The operator can switch the currently logged disk by typing the disk 
drive name (A, B, C, or D) followed by a colon (:) when the CCP is waiting for 
console input. Thus, the sequence of prompts and commands shown below might 
occur after the CP/M system is loaded from disk A: 

16K CP/M VER 1.4 

A>DIR List all files on disk A. 

SAMPLE ASM 

SAMPLE PRN 

A>B: Switch to disk B. 

B>DIR *.ASM List all "ASM" files on B. 

DUMP ASM 

FILES ASM 

B>A: Switch back to A. 



4. THE FORM OF BUILT-IN CDMMANDS. 

The file and device reference forms described above can now be used to 
fully specify the structure of the built-in commands. In the description 
below , assume the following abbreviations: 

ufh - unambiguous file reference 

afn - ambiguous file reference 

cr - carriage return 

Further, recall that the CCP always translates lower case characters to upper 
case characters internally. Thus, lower case alphabetics are treated as if 
they are upper case in command names and file references. 

4.1 ERA afn cr 

The ERA (erase) command removes files from the currently logged- in disk 
(i.e., the disk name currently prompted by CP/M preceding the ">") . The files 
which are erased are those vvhich satisfy the ambiguous file reference afn. 
The following examples illustrate the use of ERA: 

ERA X.Y The file named X.Y on the currently logged disk 

is removed from the disk directory, and the space 
is returned. 

ERA X.* All files with primary name X are removed from 

the current disk. 

ERA *.ASM All files with secondary name ASM are removed 

from the current disk. 

ERA X?Y.C?M All files on the current disk which satisfy the 

ambiguous reference X?Y.C?M are deleted. 

ERA *.* Erase all files on the current disk (in this case 

the CCP prompts the console with the message 

"ALL FILES (Y/N)?" 
which requires a Y response before files are 
actually removed) . 

ERA B:*.PRN All files on drive B which satisfy the ambiguous 

reference ????????. PRN are deleted, independently 
of the currently logged disk. 



4.2. DIR afn cr 

The DIR (directory) command causes the names of all files which satisfy 
the ambiguous file name afn to be listed at the console device. As a special 
case, the command 

DIR 

lists the files on the currently logged disk (the command "DIR" is equivalent 
to the command "DIR *.*"). Valid DIR commands are shown below. 

DIR X.Y 

DIR X?Z.C?M 

DIR ??.Y 

Similar to other CCP commands, the afn can be preceded by a drive name. 
The following DIR commands cause the selected drive to be addressed before the 
directory search takes place. 

DIR B: 

DIR B:X.Y 

DIR B:*.A?M 

If no files can be found on the selected diskette which satisfy the 
directory request, then the message "NOT FOUND" is typed at the console. 



4.3. REN ufnl=ufn2 cr 

The REN (rename) command allows the user to change the names of files on 
disk. The file satisfying ufn2 is changed to ufnl. The currently logged disk 
is assumed to contain the file to rename (ufnl) . The CCP also allows the user 
to type a left-directed arrow instead of the equal sign, if the user's console 
supports this graphic character. Examples of the REN command are 



REN X.Y=Q.R 

REN XYZ.OOM=XYZ.XXX 



The file Q.R is changed to X.Y. 

The file XYZ.XXX is changed to XYZ.COM. 



The operator can precede either ufnl or ufn2 (or both) by an optional 
drive address. Given that ufnl is preceded by a drive name, then ufn2 is 
assumed to exist on the same drive as ufnl. Similarly, if ufn2 is preceded by 
a drive name, then ufnl is assumed to reside on that drive as well. If both 
ufnl and ufh2 are preceded by drive names, then the same drive must be 



specified in both cases. The following REN commands illustrate this format. 

REN ArX.ASM = Y.ASM The file Y.ASM is changed to X.ASM on 

drive A. 

REN B:ZAP.BAS=ZOT.BAS The file ZOT.BAS is changed to ZAP.BAS 

on drive B. 

REN BrA.ASM = BrA.BAK The file A.BAK is renamed to A.ASM on 

drive B. 

If the file ufhl is already present, the REN command will respond with 
the error "FILE EXISTS" and not perform the change. If ufn2 does not exist on 
the specified diskette, then the message "NOT POUND" is printed at the 
console. 



4.4. SAVE n ufn cr 

The SAVE command places n pages (256-byte blocks) onto disk from the TPA 
and names this file ufh. In the CP/M distribution system, the TPA starts at 
100H (hexadecimal), which is the second page of memory. Thus, if the user's 
program occupies the area from 100H through 2FFH, the SAVE command must 
specify 2 pages of memory. The machine code file can be subsequently loaded 
and executed. Examples are: 

SAVE 3 X.COM Copies 100H through 3FFH to X.OOM. 

SAVE 40 Q Copies 100H through 28FFH to Q (note 

that 28 is the page count in 28FFH, 
and that 28H = 2*16+8 = 40 decimal) . 

SAVE 4 X.Y Copies 100H through 4FFH to X.Y. 

The SAVE command can also specify a disk drive in the afn portion of the 
command, as shown below. 

SAVE 10 B: ZOT.COM Copies 10 pages (100H through 0AFFH) to 

the file Z0T.COM on drive B. 



4.5. TYPE ufn cr 

The TYPE command displays the contents of the ASCII source file ufn on 
the currently logged disk at the console device. Valid TYPE commands are 

TYPE X.Y 



TYPE X.PIM 

TYPE XXX 

The TYPE command expands tabs (clt-I characters) , assumming tab positions 
are set at every eighth column. The ufn can also reference a drive name as 
shown below. 

TYPE BrX.PRN The file X.PRN from drive B is displayed. 
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5. LINE EDITING AND OUTPUT CONTROL. 

The CCP allows certain line editing functions while typing command lines. 

rubout Delete and echo the last character typed at the 

console. 

ctl-U Delete the entire line typed at the console. 

ctl-X (Same as ctl-U) 

ctl-R Retype current command line: types a "clean line" fol- 

lowing character deletion with rubouts. 

ctl-E Physical end of line: carriage is returned, but line 

is not sent until the carriage return key is depressed. 

ctl-C CP/M system reboot (warm start) 

ctl-Z End input from the console (used in PIP and ED) . 

The control functions ctl-P and ctl-S affect console output as shown below. 

ctl-P Copy all subsequent console output to the currently 

assigned list device (see the STAT command) . Output 
is sent to both the list device and the console device 
until the next ctl-P is typed. 

ctl-S Stop the console output temporarily. Program execution 

and output continue when the next character is typed 
at the console (e.g., another ctl-S). This feature is 
used to stop output on high speed consoles, such as 
CRT's, in order to view a segment of output before con- 
tinuing. 

Note that the ctl-key sequences shown above are obtained by depressing the 

control and letter keys simultaneously. Further, CCP command lines can 

generally be up to 255 characters in length; they are not acted upon until the 
carriage return key is typed. 
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6. TRANSIENT COMMANDS. 

Transient commands are loaded from the currently logged disk and executed 
in the TPA. The transient commands defined for execution under the CCP are 
shown below. Additional functions can easily be defined by the user (see the 
LOAD command definition) . 



STAT 



ASM 



LOAD 



DDT 
PIP 

ED 

SYSGEN 

SUBMIT 

DUMP 

MOVCPM 



List the number of bytes of storage remaining on the 
currently logged disk, provide statistical information 
about particular files, and display or alter device 
assignment. 

Load the CP/M assembler and assemble the specified 
program from disk. 

Load the file in Intel "hex" machine code format and 
produce a file in machine executable form which can be 
loaded into the TPA (this loaded program becomes a 
new command under the CCP) . 

Load the CP/M debugger into TPA and start execution. 

Load the Peripheral Interchange Program for subsequent 
disk file and peripheral transfer operations. 

Load and execute the CP/M text editor program. 

Create a new CP/M system diskette. 

Submit a file of commands for batch processing. 

Dump the contents of a file in hex. 

Regenerate the CP/M system for a particular memory 
size. 



Transient commands are specified in the same manner as built-in commands, and 
additional commands can be easily defined by the user. As an added 
convenience, the transient command can be preceded by a drive name, which 
causes the transient to be loaded from the specified drive into the TPA for 
execution. Thus, the command 

B:STAT 

causes CP/M to temporarily "log in" drive B for the source of the STAT 
transient, and then return to the original logged disk for subsequent 
processing. 
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The basic transient commands are listed in detail below. 

6,1. STAT cr 

The STAT command provides general statistical information about file 
storage and device assignment. It is initiated by typing one of the following 
forms: 

STAT cr 

STAT "command line" cr 

Special forms of the "command line" allow the current device assignment to be 
examined and altered as well. The various command lines which can be 
specified are shown below, with an explanation of each form shown to the 
right. 



STAT cr 



STAT x: cr 



STAT afn cr 



If the user types an empty command line, the STAT 
transient calculates the storage remaining on all 
active drives, and prints a message 



or 



x: R/W, SPACE: nnnK 
x: R/0, SPACE: nnnK 



for each active drive x, where R/W indicates the 
drive may be read or written, and R/0 indicates 
the drive is read only (a drive becomes R/O by 
explicitly setting it to read only, as shown 
below, or by inadvertantly changing diskettes 
without performing a warm start) . The space 
remaining on the diskette in drive x is given 
in kilobytes by nnn. 

If a drive name is given, then the drive is 
selected before the storage is computed. Thus, 
the command "STAT B:" could be issued while 
logged into drive A, resulting in the message 

BYTES REMAINING ON B: nnnK 

The command line can also specify a set of files 
to be scanned by STAT. The files which satisfy 
afn are listed in alphabetical order, with stor- 
age requirements for each file under the heading 

RECS BYTS EX D: FILENAME. TYP 
rrrr bbbK ee d:pppppppp.sss 

where rrrr is the number of 128-byte records 
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allocated to the file, bbb is the number of kilo- 
bytes allocated to the file (bbb=rrrr*128/1024) , 
ee is the number of 16K extensions (ee=bbb/16) , 
d is the drive name containing the file (A. ..Z) , 
pppppppp is the (up to) eight-character primary 
file name, and sss is the (up to) three-character 
secondary name. After listing the individual 
files, the storage usage is summarized*. 

STAT x:afn cr As a convenience, the drive name can be given 

ahead of the afn. In this case, the specified 
drive is first selected, and the form "STAT afn" 
is executed. 

STAT x:=R/0 cr This form sets the drive given by x to read-only, 

which remains in effect until the next warm or 
cold start takes place. When a disk is read-only, 
the message 

BDOS ERR ON x: READ ONLY 

will appear if there is an attempt to write to 
the read-only disk x. CP/M waits until a key 
is depressed before performing an automatic warm 
start (at which time the disk becomes R/W) . 

The STAT command also allows control over the physical to logical device 
assignment (see the IOBYTE function described in the manuals "CP/M Interface 
Guide" and "CP/M System Alteration Guide"). In general, there are four 
logical peripheral devices which are, at any particular instant, each assigned 
to one of several physical peripheral devices. The four logical devices are 
named: 

CON: The system console device (used by CCP 

for communication with the operator) 

RDR: The paper tape reader device 

PUN: The paper tape punch device 

LST: The output list device 

The actual devices attached to any particular computer system are driven 
by subroutines in the BIOS portion of CP/M. Thus, the logical RDR: device, 
for example, could actually be a high speed reader, Teletype reader, or 
cassette tape. In order to allow some flexibility in device naming and 
assignment, several physical devices are defined, as shown below: 
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TTY: Teletype device (slow speed console) 

CRT: Cathode ray tube device (high speed console) 

BAT: Batch processing (console is current RDR: , 

output goes to current LST: device) 

UC1: User-defined console 

PTR: Paper tape reader (high speed reader) 

UR1: User-defined reader #1 

UR2: User-defined reader #2 

PTP: Paper tape punch (high speed punch) 

UP1: User-defined punch #1 

UP2: User-defined punch #2 

LPT: Line printer 

UL1: User-defined list device #1 

It roust be emphasized that the physical device names may or may not 
actually correspond to devices which the names imply. That is, the PTP: 
device may be implemented as a cassette write operation, if the user wishes. 
The exact correspondence and driving subroutine is defined in the BIOS portion 
of CP/M. In the standard distribution version of CP/M, these devices 
correspond to their names on the MDS 800 development system. 

The possible logical to physical device assignments can be displayed by 
typing 

STAT VAL: cr 

The STAT prints the possible values which can be taken on for each logical 
device: 

CON. = TTY: CRT: BAT: UC1 

RDR: = TTY: PTR: UR1: UR2 

PUN: = TTY: PTP: UPl: UP2 

LST: = TTY: CRT: LPT: UL1 

In each case, the logical device shown to the left can take any of the four 
physical assignments shown to the right on each line. The current logical to 
physical mapping is displayed by typing the command 

STAT DEV: cr 
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which produces a listing of each logical device to the left, and the current 
corresponding physical device to the right. For example, the list might 
appear as follows: 

00N: = CRT: 

RDR: = UR1: 

PUN: = FTP: 

LST: = TTY: 

The current logical to physical device assignment can be changed by typing a 
STAT command of the form 

STAT ldl = pdl, ld2 = pd2 , ... r ldn = pdn cr 

where ldl through ldn are logical device names, and pdl through pdn are 
compatible physical device names (i.e., ldi and pdi appear on the same line in 
the "VALj" command shown above). The following are valid STAT commands which 
change the current logical to physical device assignments: 

STAT CDN:=CRT: cr 

STAT PUN: = TTY: ,LST:=LPT: , RDR:=TTY: cr 



6.2. ASM ufn cr 

The ASM command loads and executes the CP/M 8080 assembler. The ufn 
specifies a source file containing assembly language statements where the 
secondary name is assumed to be ASM, and thus is not specified. The following 
ASM commands are valid: 

ASM X 

ASM GAMMA 

The two-pass assembler is automatically executed. If assembly errors occur 
during the second pass, the errors are printed at the console. 

xiiG assenkjxer prouuces a i.ixe 

x.PEN 

where x is the primary name specified in the ASM command. The PRN file 
contains a listing of the source program (with imbedded tab characters if 
present in the source program) , along with the machine code generated for each 
statement and diagnostic error messages, if any. The PRN file can be listed 
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at the console using the TYPE command, or sent to a peripheral device using 
PIP (see the PIP command structure below) . Note also that the PRN file 
contains the original source program, augmented by miscellaneous assembly 
information in the leftmost 16 columns (program addresses and hexadecimal 
machine code, for example). Thus, the PRN file can serve as a backup for the 
original source file: if the source file is accidently removed or destroyed, 
the PRN file can be edited (see the ED operator's guide) by removing the 
leftmost 16 characters of each line (this can be done by issuing a single 
editor "macro" command) . The resulting file is identical to the original 
source file and can be renamed (REN) from PRN to ASM for subsequent editing 
and assembly. The file 

x.HEX 

is also produced which contains 8080 machine language in Intel "hex" format 
suitable for subsequent loading and execution (see the LOAD command) . For 
complete details of CP/M's assembly language program, see the "CP/M Assembler 
Language (ASM) User's Guide." 

Similar to other transient commands, the source file for assembly can be 
taken from an alternate disk by prefixing the assembly language file name by a 
disk drive name. Thus, the command 

ASM B:ALPHA cr 

loads the assembler from the currently logged drive and operates upon the 
source program ALPHA.ASM on drive B. The HEX and PRN files are also placed on 
drive B in this case. 



6.3. LOAD ufn cr 

The LOAD command reads the file ufn, which is assumed to contain "hex" 
format machine code, and produces a memory image file which can be 
subsequently executed. The file name ufn is assumed to be of the form 

x.HEX 

and thus only the name x need be specified in the command. The LOAD command 
creates a file named 

x.OOM 

which marks it as containing machine executable code. The file is actually 
loaded into memory and executed when the user types the file name x 
immediately after the prompting character ">" printed by the CCP. 

In general, the CCP reads the name x following the prompting character 
and looks for a built-in function name. If no function name is found, the CCP 
searches the system disk directory for a file by the name 
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x.OOM 

If found, the machine code is loaded into the TPA, and the program executes. 
Thus, the user need only LOAD a hex file once; it can be subsequently 
executed any number of times by simply typing the primary name. In this way, 
the user can "invent" new commands in the CCP. (Initialized disks contain the 
transient commands as 00M files, which can be deleted at the user's option.) 
The operation can take place on an alternate drive if the file name is 
prefixed by a drive name. Thus, 

LOAD BrBETA 

brings the LOAD program into the TPA from the currently logged disk and 
operates upon drive B after execution begins. 

It must be noted that the BETA. HEX file must contain valid Intel format 
hexadecimal machine code records (as produced by the ASM program, for example) 
which begin at 100H, the beginning of the TPA. Further, the addresses in the 
hex records must be in ascending order; gaps in unfilled memory regions are 
filled with zeroes by the LOAD command as the hex records are read. Thus, 
LOAD must be used only for creating CP/M standard "COM" files which operate in 
the TPA. Programs which occupy regions of memory other than the TPA can be 
loaded under DDT. 



6.4. PIP cr 

PIP is the CP/M Peripheral Interchange Program which implements the basic 
media, conversion operations necessary to load, print, punch, copy, and combine 
disk files. The PIP program is initiated by typing one of the following forms 

(1) PIP cr 

(2) PIP "command line" cr 

In both cases, PIP is loaded into the TPA and executed. In case (1) , PIP 
reads command lines directly from the console, prompted with the "*" 
character, until an empty command line is typed (i.e., a single carriage 
return is issued by the operator) . Each successive command line causes some 
media conversion to take place according to the rules shown below. Form (2) 
of the PIP command is equivalent to the first, except that the single command 
line given with the PIP command is automatically executed, and PIP terminates 
immediately with no further prompting of the console for input command lines. 
The form of each command line is 

destination = source#l, source#2, ... , source#n cr 

where "destination" is the file or peripheral device to receive the data, and 
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"source#l, . .., source#n" represents a series of one or more files or devices 
which are copied from left to right to the destination. 

When multiple files are given in the command line (i.e, n > 1) , the 
individual files are assumed to contain ASCII characters, with an assumed CP/M 
end-of-file character (ctl-Z) at the end of each file (see the parameter to 
override this assumption) . The equal symbol (=) can be replaced by a 
left-oriented arrow, if your console supports this ASCII character, to improve 
readability. Lower case ASCII alphabetics are internally translated to upper 
case to be consistent with CP/M file and device name conventions. Finally, 
the total command line length cannot exceed 255 characters (ctl-E can be used 
to force a physical carriage return for lines which exceed the console width) . 

The destination and source elements can be unambiguous references to CP/M 
source files, with or without a preceding disk drive name. That is, any file 
can be referenced with a preceding drive name (A:, B:, C:, or D:) which 
defines the particular drive where the file may be obtained or stored. When 
the drive name is not included, the currently logged disk is assumed. 
Further, the destination file can also appear as one or more of the source 
files, in which case the source file is not altered until the entire 
concatenation is complete. If the destination file already exists, it is 
removed if the command line is properly formed (it is not removed if an error 
condition arises) . The following command lines (with explanations to the 
right) are valid as input to PIP: 



X = Y cr 



X = Y,Z cr 



:^; 



X.ASM=Y.ASM,Z.ASM,FIN.ASM cr 



NEW.ZOT = BrOLD.ZAP cr 



B:A.U = B:B.V,A:C.W,D.X cr 



Copy to file X from file Y, 
where X and Y are unambiguous 
file names; Y remains unchanged. 

Concatenate files Y and Z and 
copy to file X, with Y and Z 
unchanged. 

Create the file X.ASM from the 
concatenation of the Y, Z, and 
FIN files with type ASM. 

Move a copy of OLD. ZAP from drive 
B to the currently logged disk; 
name the file NEW.ZOT. 

Concatenate file B.V from drive B 
with C.W from drive A and D.X. 
from the logged disk; create 
the file A.U on drive B. 



For more convenient use, PIP allows abbreviated commands for transferring 
files between disk drives. The abbreviated forms are 
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PIP x:=afn cr 

PIP x:=y:afn cr 

PIP ufn = y: cr 

PIP x:ufh = y: cr 

The first form copies all files from the currently loqged disk which satisfy 
the afn to the same file names on drive x (x = A. . .Z). The second form is 
equivalent to the first, where the source for the copy is drive y (y = A... 
Z) . The third form is equivalent to the command "PIP ufn=y:ufn cr" which 
copies the file given by ufn from drive y to the file ufn on drive x. The 
fourth form is equivalent to the third, where the source disk is explicitly 
given by y. 

Note that the source and destination disks must be different in all of 
these cases. If an afn is specified, PIP lists each ufn which satisfies the 
afn as it is being copied. If a file exists by the same name as the 
destination file, it is removed upon successful completion of the copy, and 
replaced by the copied file. 

The following PIP commands give examples of valid disk-to-disk copy 
operations: 



B:=*.(DM cr 

A:=B:ZAP.* cr 

ZAP.ASM=B: cr 
B:ZOT.CDM=A: cr 
B:=GAMMA.BAS cr 
B :=A: GAMMA. BAS cr 



Copy all files which have the 
secondary name "COM" to drive B 
from the current drive. 

Copy all files which have the 
primary name "ZAP" to drive A 
from drive B. 

Equivalent to ZAP.ASM=B:ZAP.ASM 

Equivalent to B:ZOT.OOM=A: Z0T.COM 

Same as B: GAMMA. BAS=GAMMA. BAS 

Same as B: GAMMA. BAS=A: GAMMA. BAS 



PIP also allows reference to physical and logical devices which are 
attached to the CP/M system. The device names are the same as given under the 
STAT command, along with a number of specially named devices. The logical 
devices given in the STAT command are 

CON: (console) , RDR: (reader) , PUN: (punch) , and 1ST: (list) 

while the physical devices are 



20 



TTY: (console, reader, punch, or list) 

CRT: (console, or list) , UC1: (console) 

PTR: (reader) , UR1: (reader) , UR2: (reader) 

PTP: (punch), UPl: (punch), UP2: (punch) 

LPT: (list) , UL1: (list) 

(Note that the "BAT:" physical device is not included, since this assignment 
is used only to indicate that the RDR: and LST: devices are to be used for 
console input/output.) 

The RDR, 1ST, PUN, and CON devices are all defined within the BIOS 
portion of CP/M, and thus are easily altered for any particular I/O system. 
(The current physical device mapping is defined by IOBYTE; see the "CP/M 
Interface Guide" for a discussion of this function) . The destination device 
must be capable of receiving data (i.e., data cannot be sent to the punch), 
and the source devices must be capable of generating data (i.e., the LST: 
device cannot be read) . 

The additional device names which can be used in PIP commands are 

NUL: Send 40 "nulls" (ASCII 0's) to the device 

(this can be issued at the end of punched output) . 

EOF: Send a CP/M end-of-file (ASCII ctl-Z) to the 
destination device (sent automatically at the 
end of all ASCII data transfers through PIP) . 

INP: Special PIP input source which can be "patched" 
into the PIP program itself: PIP gets the input 
data character-by-character by CALLing location 
103H, with data returned in location 109H (parity 
bit must be zero) . 

OUT: Special PIP output destination which can be 

patched into the PIP program: PIP CALLS location 
106H with data in register C for each character 
to transmit. Note that locations 109H through 
1FFH of the PIP memory image are not used and 
can be replaced by special purpose drivers using 
DDT (see the DDT operator's manual) . 

PRN: Same as LST:, except that tabs are expanded at 
every eighth character position, lines are 
numbered, and page ejects are inserted every 60 
lines, with an initial eject (same as [t8np]). 

File and device names can be interspersed in the PIP commands. In each 
case, the specific device is read until end-of-file (ctl-Z for ASCII files, 
and a real end of file for non-ASCII disk files) . Data from each device or 
file is concatenated from left to right until the last data source has been 
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read. The destination device or file is written using the data from the 
source files, and an end-of-file character (ctl-Z) is appended to the result 
for ASCII files. Note if the destination is a disk file, then a temporary 
file is created ($$$ secondary name) which is chanqed to the actual file name 
only upon successful completion of the copy. Files with the extension "COM" 
are always assumed to be non-ASCII. 

The copy operation can be aborted at any time by depressing any key on 
the keyboard (a rubout suffices) . PIP will respond with the message "ABORTED" 
to indicate that the operation was not completed. Note that if any operation 
is aborted, or if an error occurs during processing, PIP removes any pending 
commands which were set up while usinq the SUBMIT command. 

It should also be noted that PIP performs a special function if the 
destination is a disk file with type "HEX" (an Intel hex formatted machine 
code file) , and the source is an external peripheral device, such as a paper 
tape reader. In this case, the PIP program checks to ensure that the source 
file contains a properly formed hex file, with legal hexadecimal values and 
checksum records. When an invalid input record is found, PIP reports an error 
message at the console and waits for corrective action. It is usually 
sufficient to open the reader and rerun a section of the tape (pull the tape 
back about 20 inches). When the tape is ready for the re-read, type a singie 
carriage return at the console, and PIP will attempt another read. If the 
tape position cannot be properly read, simply continue the read (by typing a 
return following the error message) , and enter the record manually with the ED 
program after the disk file is constructed. For convenience, PIP allows the 
end-of-file to be entered from the console if the source file is a RDR: 
device. In this case, the PIP program reads the device and monitors the 
keyboard. If ctl-Z is typed at the keyboard, then the read operation is 
terminated normally. 

Valid PIP commands are shown below. 



PIP 1ST: = X.PRN cr 



Copy X.PRN to the LST device and 
terminate the PIP program. 



PIP cr 



Start PIP for a sequence of 
commands (PIP prompts with "*") 



*OON:=X.ASM,Y.ASM,Z.ASM cr 



Concatenate three ASM files and 

S-SVVtTT i.^ i.U« /"VYVT J^-,,1 ~* 



*X.HEX=CON:,Y.HEX,PTR: cr 



Create a HEX file by reading the 
CON (until a ctl-Z is typed) , fol- 
lowed by data from Y.HEX, followed 
by data from PTR until a ctl-Z is 
encountered. 



r cr 



Single carriage return stops PIP. 
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PIP PUN:=NUL:,X.ASM,EOF:,NUL: cr Send 40 nulls to the punch device; 

then copy the X.ASM file to the 
punch, followed by an end-of-file 
(ctl-Z) and 40 more null charac- 
ters. 

The user can also specify one or more PIP parameters, enclosed in left 
and right square brackets, separated by zero or more blanks. Each parameter 
affects the copy operation, and the enclosed list of parameters must 
immediately follow the affected file or device. Generally, each parameter can 
be followed by an optional decimal integer value (the S and parameters are 
exceptions) . The valid PIP parameters are listed below. 

B Block mode transfer: data is buffered by PIP until an ASCII 
x-off character (ctl-S) is received from the source device. 
This allows transfer of data to a disk file from a continuous 
reading device, such as a cassette reader. Upon receipt of 
the x-off, PIP clears the disk buffers and returns for more 
input data. The amount of data which can be buffered is de- 
pendent upon the memory size of the host system (PIP will 
issue an error message if the buffers overflow) . 

Dn Delete characters which extend past column n in the transfer 
of data to the destination from the character source. This 
parameter is used most often to truncate long lines which are 
sent to a (narrow) printer or console device. 

E Echo all transfer operations to the console as they are being 
performed. 

F Filter form feeds from the file. All imbedded form feeds are 
removed. The P parameter can be used simultaneously to 
insert new form feeds. 

H Hex data transfer: all data is checked for proper Intel hex 
file format. Non-essential characters between hex records 
are removed during the copy operation. The console will be 
prompted for corrective action in case errors occur. 

I Ignore ":00" records in the transfer of Intel hex format 
file (the I parameter automatically sets the H parameter) . 

L Translate upper case alphabetics to lower case. 

N Add line numbers to each line transferred to the destination 
starting at one, and incrementing by 1. Leading zeroes are 
suppressed, and the number is followed by a colon. If N2 
is specified, then leading zeroes are included, and a tab is 
inserted following the number. The tab is expanded if T is 
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set. 

Object file (non-ASCII) transfer: the normal CP/M end of 
file is ignored. 

Pn Include page ejects at every n lines (with an initial oage 
eject). If n = 1 or is excluded altogether, page ejects 
occur every 60 lines. If the F parameter is used, form feed 
suppression takes place before the new page ejects are 
inserted. 

Qs f z Quit copying from the source device or file when the 
string s (terminated by ctl-Z) is encountered. 

Ss*z Start copying from the source device when the string s is 
encountered (terminated by ctl-Z). The S and parameters 
can be used to "abstract" a particular section of a file 
(such as a subroutine) . The start and quit strings are al- 
ways included in the copy operation. 

NOTE - the strings following the s and g parameters are 
translated to upper case by the CCP if form (2) of the 
PIP command is used. Form (1) of the PIP invocation, how- 
ever, does not perform the automatic upper case translation. 

(1) PIP cr 

(2) PIP "command line" cr 

Tn Expand tabs (ctl-I characters) to every nth column during the 

transfer of characters to the destination from the source. 

U Translate lower case alphabetics to upper case during the 

the copy operation. 

V Verify that data has been copied correctly by rereading 

after the write operation (the destination must be a disk 
file) . 

Z Zero the parity bit on input for each ASCII character. 

The following are valid PIP commands which specify parameters in the file 
transfer: 

PIP X.ASM=B: [v] cr Copy X.ASM from drive B to the current drive 

and verify that the data was properly copied. 

PIP LPT:=X.ASM[nt8u] cr Copy X.ASM to the LPT: device? number each 

line, expand tabs to every eighth column, and 
translate lower case alphabetics to upper 
case. 
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PIP PUN:=X.HEX[i] ,Y.ZOT[h] cr First copy X.HEX to the PUN: device and 

ignore the trailing " :00" record in X.HEX; 
then continue the transfer of data by reading 
Y.ZOT, which contains hex records, including 
any " :00" records which it contains. 

PIP X.LIB = Y.ASM [ sSUBRl: f z qJMP L3 T z ] cr Copy from the file Y.ASM 

into the file X.LIB. Start the copy when the 
string "SUBR1:" has been found, and quit copy- 
ing after the string "JMP L3" is encountered. 



PIP PRN:=X.ASM[p50] Send X.ASM to the LST: device, with line num- 
bers, tabs expanded to every eighth column, 
and page ejects at every 50th line. Note that 
nt8p60 is the assumed parameter list for a PRN 
file; p50 overrides the default value. 



6.5. ED ufn cr 

The ED program is the CP/M system context editor, which allows creation 
and alteration of ASCII files in the CP/M environment. Complete details of 
operation are given the ED user's manual, "ED: a Context Editor for the CP/M 
Disk System." In general, ED allows the operator to create and operate upon 
source files which are organized as a sequence of ASCII characters, separated 
by end-of-line characters (a carriage-return line- feed sequence) . There is no 
practical restriction on line length (no single line can exceed the size of 
the working memory) , which is instead defined by the number of characters 
typed between cr's. The ED program has a number of commands for character 
string searching, replacement, and insertion, which are useful in the creation 
and correction of programs or text files under CP/M. Although the CP/M has a 
limited memory work space area (approximately 5000 characters in a 16K CP/M 
system) , the file size which can be edited is not limited, since data is 
easily "paged" through this work area. 

Upon initiation, ED creates the specified source file, if it does not 
exist, and opens the file for access. The programmer then "appends" data from 
the source file into the work area, if the source file already exists (see the 
A command), for editing. The appended data can then be displayed, altered, 
and written from the work area back to the disk (see the W command). 
Particular points in the program can be automatically paged and located by 
context (see the N command) , allowing easy access to particular portions of a 
large file. 

Given that the operator has typed 

ED X.ASM cr 
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the ED program creates an intermediate work file with the name 

X.$$$ 

to hold the edited data during the ED run. Upon completion of ED f the X.ASM 
file (original file) is renamed to X.BAK, and the edited work file is renamed 
to X.ASM. Thus, the X.BAK file contains the original (unedited) file, and the 
X.ASM file contains the newly edited file. The operator can always return to 
the previous version of a file by removing the most recent version, and 
renaming the previous version. Suppose, for example, that the current X.ASM 
file was improperly edited; the sequence of CCP command shown below would 
reclaim the backup file. 

DIR X.* Check to see that BAK file 

is available. 

ERA X.ASM Erase most recent version. 

REN X.ASM=X.BAK Rename the BAK file to ASM. 

Note that the operator can abort the edit at any point (reboot, power failure, 
ctl-C, or Q command) without destroying the original file. In this case, the 
BAK file is not created, and the original file is always intact. 

The ED program also allows the user to "ping-pong" the source and create 
backup files between two disks. The form of the ED command in this case is 

ED ufn d: 

where ufn is the name of a file to edit on the currently logged disk, and d is 
the name of an alternate drive. The ED program reads and processes the source 
file, and writes the new file to drive d, using the name ufn. Upon completion 
of processing, the original file becomes the backup file. Thus, if the 
operator is addressing disk A, the following command is valid: 

ED X.ASM B: 

which edits the file X.ASM on drive A, creating the new file X.$$$ on drive 
u. Upon cGnripj.eL.ion o±. a successj-Uj. euit, AiX.ASM is rename^ to AtX.BAK, ar»-i 
B:X.$$$ is renamed to B: X.ASM. For user convenience, the currently logged 
disk becomes drive B at the end of the edit. Note that if a file by the name 
B:X.ASM exists before the editing begins, the message 

FILE EXISTS 

is printed at the console as a precaution against accidently destroying a 
source file. In this case, the operator must first ERAse the existing file 
and then restart the edit operation. 
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Similar to other transient commands, editing can take place on a drive 
different from the currently logged disk by preceding the source file name by 
a drive name. Examples of valid edit requests are shown below 

ED A-.X.ASM Edit the file X.ASM on drive A, with 

new file and backup on drive A. 

ED B:X.ASM A: Edit the file X.ASM on drive B to the 

temporary file X.$$$ on drive A. On 
termination of editing, change X.ASM 
on drive B to X.BAK, and change X.$$$ 
on drive A to X.ASM. 

6.6. SYSGEN cr 

The SYSGEN transient command allows generation of an initialized diskette 
containing the CP/M operating system. The SYSGEN program prompts the console 
for commands, with interaction as shown below. 

SYSGEN cr Initiate the SYSGEN program. 

SYSGEN VERSION m.m SYSGEN sign-on message. 

SOURCE DRIVE NAME (OR RETURN TO SKIP) 

Respond with the drive name (one 
of the letters A, B, C, or D) of 
the disk containing a CP/M sys- 
tem; usually A. If a copy of 
CP/M already exists in memory, 
due to a MOVCPM command, type a 
cr only. Typing a drive name 
x will cause the response: 

SOURCE ON x THEN TYPE RETURN Place a diskette containing the 

CP/M operating system on drive 
x (x is one of A, B, C, or D) . 
Answer with cr when ready. 

FUNCTION COMPLETE System is copied to memory. 

SYSGEN will then prompt with: 

DESTINATION DRIVE NAME (OR RETURN TO REBOOT) 

If a diskette is being ini- 
tialized, place the new disk 
into a drive and answer with 
the drive name. Otherwise, type 
a cr and the system will reboot 
from drive A. Typing drive name 
x will cause SYSGEN to prompt 
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with: 

DESTINATION ON x THEN TYPE RETURN Place new diskette into drive 

x; type return when ready. 

FUNCTION COMPLETE New diskette is initialized 

in drive x. 

The " DESTINATION" prompt will be repeated until a single carriage return is 
typed at the console, so that more than one disk can be initialized. 

Upon completion of a successful system generation, the new diskette 
contains the operating system, and only the built-in commands are available. 
A factory- fresh IBM-compatible diskette appears to CP/M as a diskette with an 
empty directory; therefore, the operator must copy the appropriate COM files 
from an existing CP/M diskette to the newly constructed diskette using the PIP 
transient. 

The user can copy all files from an existing diskette by typing the PIP 
command 

PIP B: = A: *.*[v] cr 

which copies all files from disk drive A to disk drive B, and verifies that 
each file has been copied correctly. The name of each file is displayed at 
the console as the copy operation proceeds. 

It should be noted that a SYSGEN does not destroy the files which already 
exist on a diskette; it results only in construction of a new operating 
system. Further, if a diskette is being used only on drives B through D, and 
will never be the source of a bootstrap operation on drive A, the SYSGEN need 
not take place. In fact, a new diskette needs absolutely no initialization to 
be used with CP/M. 



6.7. SUBMIT ufn parm#l ... parm#n cr 

The SUBMIT command allows CP/M commands to be batched together for 
automatic processing. The ufn given in the SUBMIT command must be the 
filename of a file which exists on the currently logged disk, with an assumed 
file type of "SUB." The SUB file contains CP/M prototype commands, with 
possible parameter substitution. The actual -parameters parm#l ... parm#n are 
substituted into the prototype commands, and, if no errors occur, the file of 
substituted commands are processed sequentially by CP/M. 
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The prototype command file is created using the ED program, with 
interspersed "$" parameters of the form 

$1 $2 $3 ... $n 

corresponding to the number of actual parameters which will be included when 
the file is submitted for execution. When the SUBMIT transient is executed, 
the actual parameters parm#l ... parm#n are paired with the formal parameters 
$1 ... $n in the prototype commands. If the number of formal and actual 
parameters does not correspond, then the submit function is aborted with an 
error message at the console. The SUBMIT function creates a file of 
substituted commands with the name 

$$$.SUB 

on the logged disk. When the system reboots (at the termination of the 
SUBMIT) , this command file is read by the CCP as a source of input, rather 
than the console. If the SUBMIT function is performed on any disk other than 
drive A, the commands are not processed until the disk is inserted into drive 
A and the system reboots. Further, the user can abort command processing at 
any time by typing a rubout when the command is read and echoed. In this 
case, the $$$.SUB file is removed, and the subsequent commands come from the 
console. Command processing is also aborted if the CCP detects an error in 
any of the commands. Programs which execute under CP/M can abort processing of 
command files when error conditions occur by simply erasing any existing 
$$$.SUB file. 

In order to introduce dollar signs into a SUBMIT file, the user may type 
a "$$" which reduces to a single "$" within the command file. Further, an 
up-arrow symbol "*" may precede an alphabetic character x, which produces a 
single ctl-x character within the file. 

The last command in a SUB file can initiate another SUB file, thus 
allowing chained batch commands. 

Suppose the file ASMBL.SUB exists on disk and contains the prototype 
commands 

ASM $1 
DIR $1.* 
ERA *.BAK 
PIP $2:=$1.PRN 
ERA $1.PRN 



and the command 



SUBMIT ASMBL X PRN cr 



is issued by the operator. The SUBMIT program reads the ASMBL.SUB file, 
substituting "X" for all occurrences of $1 and "PRN" for all occurrences of 
$2, resulting in a $$$.SUB file containing the commands 
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ASM X 

DIR X.* 

ERA *.BAK 

PIP PRN:=X.PRN 

ERA X.PRN 

which are executed in sequence by the CCP. 

The SUBMIT function can access a SUB file which is on an alternate drive 
by preceding the file name by a drive name. Submitted files are only acted 
upon r however, when they appear on drive A. Thus, it is possible to create a 
submitted file on drive B which is executed at a later time when it is 
inserted in drive A. 



6.8. DUMP ufn cr 

The DUMP program types the contents of the disk file (ufn) at the console 
in hexadecimal form. The file contents are listed sixteen bytes at a time, 
with the absolute byte address listed to the left of each line in 
hexadecimal. Long typeouts can be aborted by pushing the rubout key during 
printout. (The source listing of the DUMP program is given in the "CP/M 
Interface Guide" as an example of a program written for the CP/M environment.) 



6.9. MOVCPM cr 

The MOVCPM program allows the user to reconfigure the CP/M system for any 
particular memory size. Two optional parameters may be used to indicate (1) 
the desired size of the new system and (2) the disposition of the new system 
at program termination. If the first parameter is emitted or a "*" is given, 
the MOVCPM program will reconfigure the system to its maximum size, based upon 
the kilobytes of contiguous RAM in the host system (starting aat 0000H) . If 
the second parameter is emitted, the system is executed, but not permanently 
recorded; if "*" is given, the system is left in memory, ready for a SYSGEN 
operation. The MOVCPM program relocates a memory image of CP/M and places 
this image in memory in preparation for a system generation operation. The 
command forms are: 

Relocate and execute CP/M for manage- 
ment of the current memory configura- 
tion (memory is examined for contigu- 
ous RAM, starting at 100H) . Upon com- 
pletion of the relocation, the new 
system is executed but not permanently 
recorded on the diskette. The system 
which is constructed contains a BIOS 
for the Intel MDS 800. 
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MOVCPM n cr Create a relocated CP/M system for 

management of an n kilobyte system (n 
must be in the range 16 to 64) , and 
execute the system, as described above. 

MOVCPM * * cr Construct a relocated memory image for 

the current memory configuration, but 
leave the memory image in memory, in 
preparation for a SYSGEN operation. 

MOVCPM n * cr Construct a relocated memory image for 

an n kilobyte memory system, and leave 
the memory image in preparation for a 
SYSGEN operation. 

The command 

MOVCPM * * 

for example, constructs a new version of the CP/M system and leaves it in 
memory, ready for a SYSGEN operation. The message 

READY FDR "SYSGEN" OR 
"SAVE 32 CPMxx.COM" 

is printed at the console upon completion, where xx is the current memory size 
in kilobytes. The operator can then type 

SYSGEN cr Start the system generation. 

SOURCE DRIVE NAME (OR RETURN TO SKIP) Respond with a cr to skip 

the CP/M read operation since the system 
is already in memory as a result of the 
previous MOVCPM operation. 

DESTINATION DRIVE NAME (OR RETURN T0 REBOOT) 

Respond with B to write new system 
to the diskette in drive B. SYSGEN 
will prompt with: 

DESTINATION ON B, THEN TYPE RETURN 

Ready the fresh diskette on drive 
B and type a return when ready. 

Note that if you respond with "A" rather than "B" above, the system will be 
written to drive A rather than B. SYSGEN will continue to type the prompt: 

DESTINATION DRIVE NAME (OR RETURN TO REBOOT) 

until the operator responds with a single carriage return, which stops the 
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SYSGEN program with a system reboot. 

The user can then go through the reboot process with the old or new 
diskette. Instead of performing the SYSGEN operation, the user could have 
typed 

SAVE 32 CPMxx.COM 

at the completion of the MOVCPM function, which would place the CP/M memory 
image on the currently logged disk in a form which can be "patched." This is 
necessary when operating in a non-standard environment where the BIOS must be 
altered for a particular peripheral device configuration, as described in 
the"CP/M System Alteration Guide." 

Valid MOVCPM commands are given below: 

MOVCPM 48 cr Construct a 48K verskon of CP/M and start 

execution. 

MOVCPM 48 * cr Construct a 48K version of CP/M in prepara- 
tion for permanent recording; response is 

READY FOR "SYSGEN" OR 
"SAVE 32CPM48.COM" 

MOVCPM * * cr Construct a maximum memory version of CP/M 

and start execution. 

It is important to note that the newly created system is serialized with 
the number attached to the original diskette and is subject to the conditions 
of the Digital Research Software Licensing Agreement. 
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7. BDOS ERROR MESSAGES. 

There are three error situations which the Basic Disk Operating System 
intercepts during file processsing. When one of these conditions is detected, 
the BDOS prints the message: 

BDOS ERR ON x: error 

where x is the drive name, and "error" is one of the three error messages: 

BAD SECTOR 
SELECT 
READ ONLY 

The "BAD SECTOR" message indicates that the disk controller electronics 
has detected an error condition in reading or writing the diskette. This 
condition is generally due to a malfunctioning disk controller, or an 
extremely worn diskette. If you find that your system reports this error more 
than once a month, you should check the state of your controller electronics, 
and the condition of your media. You may also encounter this condition in 
reading files generated by a controller produced by a different manufacturer. 
Even though controllers are claimed to be IBM-compatible, one often finds 
small differences in recording formats. The MDS-800 controller, for example, 
requires two bytes of one's following the data CRC byte, which is not required 
in the IBM format. As a result, diskettes generated by the Intel MDS can be 
read by almost all other IBM-compatible systems, while disk files generated on 
other manufacturer's equipment will produce the "BAD SECTOR" message when read 
by the MDS. In any case, recovery from this condition is accomplished by 
typing a ctl-C to reboot (this is the safest!) , or a return, which simply 
ignores the bad sector in the file operation. Note, however, that typing a 
return may destroy your diskette integrity if the operation is a directory 
write, so make sure you have adequate backups in this case. 

The "SELECT" error occurs when there is an attempt to address a drive 
beyond the A through D range. In this case, the value of x in the error 
message gives the selected drive. The system reboots following any input from 
the console. 

The "READ ONLY" message occurs when there is an attempt to write to a 
diskette which has been designated as read-only in a STAT command, or has been 
set to read-only by the BDOS. In general, the operator should reboot CP/M 
either by using the warm start procedure (ctl-C) or by performing a cold start 
whenever the diskettes are changed. If a changed diskette is to be read but 
not written, BDOS allows the diskette to be changed without the warm or cold 
start, but internally marks the drive as read-only. The status of the drive 
is subsequently changed to read/write if a warm or cold start occurs. Upon 
issuing this message, CP/M waits for input from the console. An automatic 
warm start takes place following any input. 
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8. OPERATION OF CP/M ON THE MDS. 

This section gives operating procedures for using CP/M on the Intel MDS 
microcomputer development system. A basic knowledge of the MD6 hardware and 
software systems is assumed. 

CP/M is initiated in essentially the same manner as Intel's ISIS 
operating system. The disk drives are labelled through 3 on the MDS, 
corresponding to CP/M drives A through D, respectively. The CP/M system 
diskette is inserted into drive 0, and the BOOT and RESET switches are 
depressed in sequence. The interrupt 2 light should go on at this point. The 
space bar is then depressed on the device which is to be taken as the system 
console, and the light should go out (if it does not, then check connections 
and baud rates) . The BOOT switch is then turned off, and the CP/M signon 
message should appear at the selected console device, followed by the "A>" 
system prompt. The user can then issue the various resident and transient 
commands 

The CP/M system can be restarted (warm start) at any time by pushing the 
INT switch on the front panel. The built-in Intel ROM monitor can be 
initiated by pushing the INT 7 switch (which generates a RST 7) , except when 
operating under DDT, in which case the DDT program gets control instead. 

Diskettes can be removed from the drives at any time, and the system can 
be shut down during operation without affecting data integrity. Note, 
however, that the user must not remove a diskette and replace it with another 
without rebooting the system (cold or warm start) , unless the inserted 
diskette is "read only." 

Due to hardware hang-ups or malfunctions, CP/M may type the message 

BDOS ERR ON x: BAD SECTOR 

where x is the drive which has a permanent error. This error may occur when 
drive doors are opened and closed randomly, followed by disk operations, or 
may be due to a diskette, drive, or controller failure. The user can 
optionally elect to ignore the error by typing a single return at the 
console. The error may produce a bad data record, requiring re-initialization 
of up to 128 bytes of data. The operator can reboot the CP/M system and try 
the operation again. 

Termination of a CP/M session requires no special action, except that it 
is necessary to remove the diskettes before turning the power off, to avoid 
random transients which often make their way to the drive electronics. 

It should be noted that factory- fresh IBM-compatible diskettes should be 
used rather than diskettes which have previously been used with any ISIS 
version. In particular, the ISIS "FORMAT" operation produces non-standard 
sector numbering throughout the diskette. This non-standard numbering 
seriously degrades the performance of CP/M, and will operate noticeably slower 
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than the distribution version. If it becomes necessary to reformat a diskette 
(which should not be the case for standard diskettes) , a program can be 
written under CP/M which causes the MD6 800 controller to reformat with 
sequential sector numbering (1-26) on each track. 

Note: "MDS 800" and "ISIS" are registered trademarks of Intel Corporation. 
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1. ED TUTORIAL 

1.1. Introduction to ED. 

ED is the context editor for CP/M, and is used to create 
and alter CP/M source files. ED is initiated in CP/M by- 
typing 

f<filename> 
ED / 

I <filename>.<filetype> 



In general, ED reads segments of the source file given by 
<filename> or <filename> . <filei:ype> into central memory, 
where the file is manipulated by the operator, and subse- 
quently written back to disk after alterations. If the 
source file does not exist before editing, it is created by 
ED and initialized to empty. The overall operation of ED 
is shown in Figure 1. 

1.2. ED Operation 

ED operates upon the source file, denoted in Figure 1 
by x.y, and passes all text through a memory buffer where 
the text can be viewed or altered (the number of lines which 
can be maintained in the memory buffer varies with the line 
length, but has a total capacity of about 6000 characters 
in a 16K CP/M system) . Text material which has been edited 
is written onto a temporary work file under command of the 
operator. Upon termination of the edit, the memory buffer 
is written to the temporary file, followed by any remaining 
(unread) text in the source file. The name of the original 
file is changed from x.y to x.BAK so that the most recent 
previously edited source file can be reclaimed if necessary 
(see the CP/M commands ERASE and RENAME) . The temporary 
file is then changed from x.$$$ to x.y which becomes the 
resulting edited file. 

The memory buffer is logically between the source file 
and working file as shown in Figure 2. 

1.3. Text Transfer Functions 

Given that n is an integer value in the range through 
65535, the following ED commands transfer lines of text 
from the source file through the memory buffer to the tem- 
porary (and eventually final) file: 



Figure 1. Overall ED Operation 




Source 
Libraries 




Note: the ED program accepts both lower and upper case ASCII 
characters as input from the console. Single letter commands 
can be typed in either case. The U command can be issued to 
cause ED to translate lower case alphabetic s to upper case as 
characters are filled to the memory buffer from the console. 
Characters are echoed as typed without translation, however. 
The -U command causes ED to revert to "no translation" mode. 
ED starts with an assumed -U in effect. 



Figure 2. Memory Buffer Organization 
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Figure 3. Logical Organization of Memory Buffer 
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nA<cr> - append the next n unprocessed source 
lines from the source file at SP to 
the end of the memory buffer at MP. 
Increment SP and MP by n. 

nW<cr> - write the first n lines of the memory 

buffer to the temporary file free space. 
Shift the remaining lines n+1 through 
MP to the top of the memory buffer. 
Increment TP by n. 

E<cr> - end the edit. Copy all buffered text 
to temporary file, and copy all un- 
processed source lines to the temporary 
file. Rename files as described 
previously. 

H<cr> - move to head of new file by performing 
automatic E command. Temporary file 
becomes the new source file, the memory 
buffer is emptied, and a new temporary 
file is created (equivalent to issuing 
an E command, followed by a reinvocation 
of ED using x.y as the file to edit). 

0<cr> - return to original file. The memory 
buffer is emptied, the temporary file 
id deleted, and the SP is returned to 
position 1 of the source file. The 
effects of the previous editing commands 
are thus nullified. 

Q<cr> - quit edit with no file alterations, 
return to CP/M. 

There are a number of special cases to consider. If the 
integer n is omitted in any ED command where an integer is 
allowed, then 1 is assumed. Thus, the commands A and W append 
one line and write 1 line, respectively. In addition, if a 
pound sign (#) is given in the place of n, then the integer 
5 55 35 is assumed ^the largest value for n which is allowed) . 
Since most reasonably sized source files can be contained 
entirely in the memory buffer, the command #A is often issued 
at the beginning of the edit to read the entire source file 
to memory. Similarly, the command #W writes the entire buffer 
to the temporary file. Two special forms of the A and W 



*<cr> represents the carriage-return key 



commands are provided as a convenience. The command OA fills 
the current memory buffer to at least half-full, while OW 
writes lines until the buffer is at least half empty. It 
should also be noted that an error is issued if the memory 
buffer size is exceded. The operator may then enter any 
command (such as W) which does not increase memory require- 
ments. The remainder of any partial line read during the 
overflow will be brought into memory on the next successful 
append. 

1.4. Memory Buffer Organization 

The memory buffer can be considered a sequence of source 
lines brought in with the A command from a source file. The 
memory buffer has an associated (imaginary) character pointer 
CP which moves throughout the memory buffer under command of 
the operator. The memory buffer appears logically as shown 
in Figure 3 where the dashes represent characters of the 
source line of indefinite length, terminated by carriage- 
return (<cr>) and line-feed (<lf>) characters, and fcp] 
represents the imaginary character pointer. Note that the 
CP is always located ahead of the first character of the 
first line, behind the last character of the last line, or 
between two characters. The current line CL is the source 
line which contains the CP. 

1.5. Memory Buffer Operation 

Upon initiation of ED, the memory buffer is empty (ie, 
CP is both ahead and behind the first and last character) . 
The operator may either append lines (A command) from the 
source file, or enter the lines directly from the console 
with the insert command 

I<cr> 

ED then accepts any number of input lines, where each line 
terminates with a <cr> (the <lf> is supplied automatically) , 
until a control-z (denoted by tz is typed by the operator. 
The CP is positioned after the last character entered. The 
sequence 

I<cr> 

NOW IS THE<cr> 
TIME FOR<cr> 
ALL GOOD MEN<cr> 

iz 

leaves the memory buffer as shown below 



NOW IS THE<cr><lf> 
TIME FOR<cr><lf> 
ALL GOOD MEN<cr><lf> 

cp 



Various commands can then be issued which manipulate the CP 
or display source text in the vicinity of the CP. The 
commands shown below with a preceding n indicate that an 
optional unsigned value can be specified. When preceded by 
±, the command can be unsigned, or have an optional preceding 
plus or minus sign. As before, the pound sign (#) is replaced 
by 65535. If an integer n is optional, but not supplied, 
then n=l is assumed. Finally, if a plus sign is optional, 
but none is specified, then + is assumed. 

±B<cr> - move CP to beginning of memory buffer 
if +, and to bottom if -. 

±nC<cr> - move CP by ±n characters (toward front 
of buffer if +) , counting the <cr><lf > 
as two distinct characters 

±nD<cr> - delete n characters ahead of CP if plus 
and behind CP if minus. 

±nK<cr> - kill (ie remove) ±n lines of source text 
using CP as the current reference. If 
CP is not at the beginning of the current 
line when K is issuea, then the charac- 
ters before CP remain if + is specified, 
while the characters after CP remain if - 
is given in the command. 

±nL<cr> - if n=0 then move CP to the beginning of 
the current line (if it is not already 
there) if n^O then first move the CP to 
the beginning of the current line, and 
then move it to the beginning of the 
line which is n lines down (if +) or up 
(if -) . The CP will stop at the top or 
bottom of the memory buffer if too large 
a value of n is specified. 



±nT<cr> - If n=0 then type the contents of the 
current line up to CP. If n=l then 
type the contents of the current line 
from CP to the end of the line. If 
n>l then type the current line along 
with n-1 lines which follow, if + 
is specified. Similarly, if n>l and 
- is given, type the previous n lines, 
up to the CP. The break key can be 
depressed to abort long type-outs. 

±n<cr> - equivalent to ±nLT, which moves up or 
down and types a single line 

1.6. Command Strings 

Any number of commands can be typed contiguously (up to 
the capacity of the CP/M console buffer) , and are executed 
only after the <cr> is typed. Thus, the operator may use 
the CP/M console command functions to manipulate the input 
command : 

Rubout remove the last character 

Control-U delete the entire line 

Control-C re-initialize the CP/M System 

Control-E return carriage for long lines 
without transmitting buffer 
(max 128 chars) 

Suppose the memory buffer contains the characters shown 
in the previous section, with the CP following the last 
character of the buffer. The command strings shown below 
produce the results shown to the right 



Command String 
1. B2T<cr> 



Effect 

move to beginning 
of buffer and type L-E 
2 lines: 
"NOW IS THE 
TIME FOR" 



Resulting Memory Buffer 

NOW IS THE<cr><lf> 
TIME FOR<cr><lf> 
ALL GOOD MEN<cr><lf> 



2. 5C0T<cr> 



move CP 5 charac- 
ters and type the 
beginning of the 
line 
"NOW I" 



NOW I/\S THE<cr><lf> 



2L-T<cr> 



-L#K<cr> 



move two lines down 
and type previous 
line 
"TIME FOR" 



move up one line, 
delte 65535 lines 
which follow 



NOW IS THE<cr><lf> 
TIME FOR<cr><lf> 
ALL GOOD MEN<cr><lf> 



NOW IS THE<c 



r><lf> /X 

an 



I<cr> 

TIME TO<cr> 

INSERT<cr> 

+ z 



-2L#T<cr> 



insert two lines 
of text 



move up two lines , 
and type 6 55 35 
lines ahead of CP 
"NOW IS THE" 



NOW IS THE<cr><lf> 
TIME TO<cr><lf> 

INSERT<cr><lf>/s 
f c P] 

NOW IS THE<cr><lf> 
TIME TO<cr><lf> 
INSERT<cr><lf> 



7. 



<cr> 



move down one line 
and type one line 
"INSERT" 



NOW IS THE<cr><lf> 
TIME TO<cr><lf> 
INSERT<cr><lf> 



1.7. Text Search and Alteration 

ED also has a command which locates strings within the 
memory buffer. The command takes the form 



nF C;L c 2 



f<cr>] 
••• c k ^ tz J 



where c^_ through c^ represent the characters to match followed 
by either a <cr> or control -z . ED starts at the current 
position of CP and attempts to match all k characters. The 
match is attempted n times, and if successful, the CP is 
moved directly after the character c^. If the n matches are 
not successful, the CP is not moved from its initial position. 
Search strings can include tl (control-1) , which is replaced 
by the pair of symbols <cr><lf>. 



*The control -z is used if additional commands will be typed 
following the tz. 
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The following commands illustrate the use of the F 
command : 



Command String 
1. B#T<cr> 



Effect 

move to beginning 
and type entire 
buffer 



Resulting Memory Buffer 

NOW IS THE<cr><lf> 
TIME FOR<cr><lf> 
ALL GOOD MEN<cr><lf> 



2. FS T<cr> 



find the end of 
the string "S T" 



NOW IS T>AsHE<cr><lf> 

fCPl 



3. FItzOTT 



find the next "I" 
and type to the 
CP then type the 
remainder of the 
current line: 
"TIME FOR" 



NOW IS THE<cr><lf> 
TI X\ M E FOR<cr><lf > 
ALL~GOOD MEN<cr><lf> 



An abbreviated form of the insert command is also allowed, 
which is often used in conjunction with the F command to make 
simple textual changes. The form is: 

I c, c~. .. c tz or 
12 n 

I c, C-. . . c <cr> 
12 n 



where cj_ through c n are characters to insert. If the inser- 
tion string is terminated by a tz, the characters C]_ through 
c n are inserted directly following the CP , and the CP is 
moved directly after character c n . The action is the same 
if the command is followed by a <cr> except that a <cr><lf> 
is automatically inserted into the text following character 
c n . Consider the following command sequences as examples 
of the F and I commands : 



Command String 



Effect 



BITHIS IS tz<cr> Insert "THIS IS " 

at the beginning 
of the text 



Resulting Memory Buffer 
THIS IS^NOW THE <cr><lf> 

TIME FOR<cr><lf> 
ALL GOOD MEN<cr><lf> 



FTIME+z-4DIPLACEtz<cr> 



find "TIME" and delete 
it; then insert "PLACE" 



THIS IS NOW THE<cr><lf> 
PLACE /V FOR<cr><lf> 
ALL GOOD MEN<cr><lf> 



3FOtz-3D5DICHANGESt<cr> 



find third occurrence 
of "O" (ie the second 
"0" in GOOD) , delete 
previous 3 characters; 
then insert "CHANGES" 



THIS IS NOW THE <cr><lf> 

PLACE F0R<cr><lf> 

ALL CHANGES /V<cr><lf> 



-8CIS0URCE<cr> 



move back 8 characters 
and insert the line 
"SOURCE<cr><lf>" 



THIS IS NOW THE<cr><lf> 
PLACE FOR<cr><lf> 
ALL SOURCE<cr><lf> 
/^CHANGES<cr><lf> 

ED also provides a single command which combines the F and 
I commands to perform simple string substitutions. The command 
takes the form 



n S Cl c 2 ...c k + Z d 1 d 2 ...d m [ < =fj 



and has exactly the same effect as applying the command string 



F c, c 2 . . .c, tz-kDId 



l d 2-'- d m (if) 



a total of n times. That is, ED searches the memory buffer 
starting at the current position of CP and successively sub- 
stitutes the second string for the first string until the 
end of buffer, or until the substitution has been performed 
n times. 

As a convenience, a command similar to F is provided by 
ED which automatically appends and writes lines as the search 
proceeds. The form is 



n N CtC?* 



{"} 



which searches the entire source file for the nth occurrence 
of the string C]_C2...cj c (recall that "F fails if the string 
cannot be found in the current buffer) . The operation of the 
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N command is precisely the same as F except in the case that 
the string cannot be found within the current memory buffer. 
In this case, the entire memory contents is written (ie, an 
automatic #W is issued) . Input lines are then read until 
the buffer is at least half full, or the entire source file 
is exhausted. The search continues in this manner until the 
string has been found n times, or until the source file has 
been completely transferred to the temporary file. 

A final line editing function, called the juxtaposition 
command takes the form 



n J c, c,...c, +z d-.d~...d +z e,e_...e 
12 k 12 m 12 q 



f<cr>\ 



with the following action applied n times to the memory buffer: 
search from the current CP for the next occurrence of the 
string c-j_C2» • • Cj,. If found, insert the string d],d2«../d m , 
and move CP to follow d m . Then delete all characters following 
CP up to (but not including) the string e-^ ,e2 , • • • e~, leaving 
CP directly after d m . If e-|_ ,e2 , . • -e q cannot be found, then 
no deletion is made. If the current line is 

/SNOW IS THE TIME<cr><lf> 



Then the command 

JW +zWHATtz+l<cr> 
Results in 



NOW WHAT J^ <cr><lf> 

(SEl 

(Recall that il represents the pair <cr><lf> in search and 
substitute strings) . 

It should be noted that the number of characters allowed 
by ED in the F,S,N, and J commands is limited to 100 symbols, 

1.8. Source Libraries 

ED also allows the inclusion of source libraries during 
the editing process with the R command. The form of this 
command is 
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R f , f n . .f tz or 
12 n 



R f,f . -f <cr> 
12 n 



where f^f2-.f n is the name of a source file on the disk with 
as assumed filetype of 'LIB'. ED reads the specified file, 
and places the characters into the memory buffer after CP , 
in a manner similar to the I command. Thus, if the command 

RMACRO<cr> 

is issued by the operator, ED reads from the file MACRO. LIB 
until the end-of-file, and automatically inserts the charac- 
ters into the memory buffer. 

1. 9. Repetitive Command Execution 

The macro command M allows the ED user to group ED com- 
mands together for repeated evaluation. The M command takes 
the form: 



n M c lC2 ...c k 



f<cr>\ 



where C]_C2«»-c^ represent a string of ED commands, not inclu- 
ding another M command. ED executes the command string n 
times if n>l. If n=0 or 1, the command string is executed 
repetitively until an error condition is encountered (e.g. , 
the end of the memory buffer is reached with an F command) . 

As an example, the following macro changes all occur- 
rences of GAMMA to DELTA within the current buffer, and 
types each line which is changed: 



MFGAMMA+Z-5DIDELTA+zOTT<cr> 
or equivalently 

MSGAMMA+zDELTA+zOTT<cr> 
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2. ED ERROR CONDITIONS 

On error conditions, ED prints the last character read 
before the error, along with an error indicator: 

? unrecognized command 

> memory buffer full (use one of 
the commands D,K,N,S, or W to 
remove characters), F,N, or S 
strings too long. 

# cannot apply command the number 
of times specified (e.g. , in 
F command ) 

cannot open LIB file in R 
command 

Cyclic redundancy check (CRC) information is written with 
each output record under CP/M in order to detect errors on 
subsequent read operations. If a CRC error is detected, CP/M 
will type 

PERM ERR DISK d 



where d is the currently selected drive (A,B,...). The oper- 
ator can choose to ignore the error by typing any character 
at the console (in this case, the memory buffer data should 
be examined to see if it was incorrectly read) , or the user 
can reset the system and reclaim the backup file, if it 
exists. The file can be reclaimed by first typing the con- 
tents of the BAK file to ensure that it contains the proper 
information: 

TYPE x.BAK<cr> 

where x is the file being edited. Then remove the primary 
file: 

ERA x.y<cr> 

and rename the BAK file: 

REN x.y=x.BAK<cr> 

The file can then be re-edited, starting with the previous 
version. 
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3. CONTROL CHARACTERS AND COMMANDS 

The following table summarizes the control characters 
and commands available in ED: 



Control Character 

te 



ti 
+ 1 

tu 

tz 
rubout 
break 



Function 

system reboot 

physical <cr><lf> (not 
actually entered in 
command) 

logical tab (cols 1,8, 
15,. . . ) 

logical <crxlf> in 
search and substitute 
strings 

line delete 

string terminator 

character delete 

discontinue command 
(e.g. , stop typing) 
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Command Function 

nA append lines 

±B begin bottom of buffer 

±nC move character positions 

±nD delete characters 

E end edit and close files 

(normal end) 

nF find string 

H end edit, close and reopen 

files 

I insert characters 

nJ place strings in juxtaposition 

±nK kill lines 

±nL move down/up lines 

nM macro definition 

nN find next occurrence with 

autoscan 

return to original file 

±nP move and print pages 

Q quit with no file changes 

R read library file 

nS substitute strings 

±nT type lines 

+ translate lower to upper case if U, 

no translation if -U 

nW write lines 

nZ sleep 

±n<cr> move and type (±nLT) 
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Appendix A: ED 1.4 Enhancements 

The ED context editor contains a number of commands which enhance its 
usefulness in text editing. The improvements are found in the addition of line numbers, 
free space interrogation, and improved error reporting. 

The context editor issued with CP/M 1.4 produces absolute line number prefixes 
when the "V" (Verify Line Numbers) command is issued. Following the V command, 
the line number is displayed ahead of each line in the format: 

nnnnn: 

where nnnnn is an absolute line number in the range 1 to 65535. If the memory buffer 
is empty, or if the current line is at the end of the memory buffer, then nnnnn appears 
as 5 blanks. 

The user may reference an absolute line number by preceding any command by 
a number followed by a colon, in the same format as the line number display. In this 
case, the ED program moves the current line reference to the absolute line number, 
if the line exists in the current memory buffer. Thus, the command 

345 :T 

is interpreted as "move to absolute line 345, and type the line." Note that absolute 
line numbers are produced only during the editing process, and are not recorded with 
the file. In particular, the line numbers will change following a deleted or expanded 
section of text. 

The user may also reference an absolute line number as a backward or forward 
distance from the current line by preceding the absolute line number by a colon. Thus, 
the command 

:400T 

is interpreted as "type from the current line number through the line whose absolute 
number is 400." Combining the two line reference forms, the command 

345::400T 

for example, is interpreted as "move to absolute line 345, then type through absolute 
line 400." Note that absolute line references of this sort can precede any of the 
standard ED commands. 

A special case of the V command, "0V", prints the memory buffer statistics in 
the form: 

free/total 

where "free" is the number of free bytes in the memory buffer (in decimal), and "total" 
is the size of the memory buffer. 



ED 1.4 also includes a "block move" facility implemented through the "X" (Xfer) 
command. The form 

nX 

transfers the next n lines from the current line to a temporary file called 

X$ $$$$$$. LIB 

which is active only during the editing process. In general, the user can reposition 
the current line reference to any portion of the source file and transfer lines to the 
temporary file. The transferred line accumulate one after another in this file, and 
can be retrieved by simply typing: 

R 

which is the trivial case of the library read command. In this case, the entire 
transferred set of lines is read into the memory buffer. Note that the X command 
does not remove the transferred lines from the memory buffer, although a K command 
can be used directly after the X, and the R command does not empty the transferred 
line file. That is, given that a set of lines has been transferred with the X command, 
they can be re-read any number of times back into the source file. The command 

flx 

is provided, however, to empty the transferred line file. 

Note that upon normal completion of the ED program through Q or E, the 
temporary LIB file is removed. If ED is aborted through ctl-C, the LIB file will exist 
if lines have been transferred, but will generally be empty (a subsequent ED invocation 
will erase the temporary file). 

Due to common typographical errors, ED 1.4 requires several potentially disas- 
terous commands to be typed as single letters, rather than in composite commands. 
The commands 

E (end), H (head), O (original), Q (quit) 

must be typed as single letter commands. 

ED 1.4 also prints error messages in the form 

BREAK "x" AT c 

where x is the error character, and c is the command where the error occurred. 
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1. AN OVERVIEW OF CP/M 2.0 FACILITIES. 

CP/M 2.0 is a high-performance single-console operating system 
which uses table driven techniques to allow field reconfiguration to 
match a wide variety of disk capacities. All of the fundamental file 
restrictions are removed, while maintaining upward compatibility from 
previous versions of release 1. Features of CP/M 2.0 include field 
specification of one to sixteen logical drives, eacn containing up to 
eight megabytes. Any particular file can reach the full drive size 
with the capaoility to expand to thirty-two megabytes in future 
releases. The directory size can be field configured to contain any 
reasonable number of entries, and each file is optionally tagged with 
read/only and system attributes. Users of CP/M 2.0 are physically 
separated oy user numbers, with facilities for file copy operations 
from one user area to another. Powerful relative-record random access 
functions are present in CP/M 2.0 which provide direct access to any 
of the 65536 records of an eight megabyte file. 

All disk-dependent portions of CP/M 2.0 are placed into a 
BIOS-resident "disk parameter block" which is either hand coded or 
produced automatically using the disk definition macro library 
provided with CP/M 2.0. The end user need only specify the maximum 
number of active disks, the starting and ending sector numbers, the 
data allocation size, the maximum extent of the logical disk, 
directory size information, and reserved track values. The macros use 
this information to generate the appropriate tables and table 
references for use during CP/M 2.0 operation. Deblocking information 
is also provided which aids in assembly or disassembly of sector sizes 
which are multiples of tne fundamental 128 byte data unit, and the 
system, alteration manual includes general-purpose subroutines which 
use the tnis deblocking information to take advantage of larger sector 
sizes. Use of these subroutines, together with the table driven data 
access algorithms, make CP/M 2.0 truly a universal data management 
system. 

File expansion is achieved by providing up to 512 logical file 
extents, where each logical extent contains 16K bytes of data. CP/M 
2.0 is structured, however, so that as much as 128K bytes of data is 
addressed by a single physical extent (corresponding to a single 
directory entry) , thus maintaining compatibility with previous 
versions while taking full advantage of directory space. 

Random access facilities are present in CP/M 2.0 which allow 
immediate reference to any record of an eight megabyte file. Using 
CP/M's unique data organization, data blocks are only allocated when 
actually required and movement to a record position requires little 
search time. Sequential file access is upward compatible from earlier 
versions to the full eight megaoytes, while random access 
compatibility stops at 512K byte files. Due to CP/M 2.0' s simpler and 
faster random access, application orogrammers are encouraged to alter 
their programs to take full advantage of the 2.0 facilities. 

Several CP/M 2.0 modules and utilities have improvements which 
correspond to the enhanced file system. STAT and PIP both account for 
file attributes and user areas, while the CCP provides a "login" 
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function to change from one user area to anotner. The CCP also 
formats directory displays in a more convenient manner and accounts 
for both CRT and hard-copy devices in its enhanced line editing 
functions. 

The sections below point out the individual differences between 
CP/M 1.4 and CP/M 2.0, witn the understanding that tne reader is 
either familiar with CP/M 1.4 r or has access to the 1.4 manuals. 
Additional information dealing with CP/M 2.0 I/O system alteration is 
presented in the Digital Research manual "CP/M 2.0 Alteration Guide. " 
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2. USER INTERFACE. 

Console line processing takes CRT-type devices into account with 
three new control characters, shown with an asterisk in the list below 
(the symbol M ctl M below indicates tnat the control key is 
simultaneously depressed) : 

rub/del removes and echoes last character 

ctl-C reboot when at beginning of line 

ctl-E physical end of line 

ctl-H oackspace one cnaracter position* 

ctl-J (line feed) terminates current input* 

ctl-M (carriage return) terminates input 

ctl-R retype current line after new line 

ctl-U remove current line after new line 

ctl-X backspace to beginning of current line* 

In particular, note tnat ctl-H produces the proper backspace overwrite 
function (ctl-H can be changed internally to another cnaracter, such 
as delete, through a simple single byte change). Further, the line 
editor keeps track of the current prompt column position so that the 
operator can properly align data input following a ctl-U, ctl-R, or 
ctl-X command. 
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3. CONSOLE COMMAND PROCESSOR (CCP) INTERFACE. 

There are four functional differences between CP/M 1.4 and CP/M 
2.0 at the console command processor (CCP) level. The CCP now 
displays directory information across the screen (four elements per 
line) , the USER command is present to allow maintenance of separate 
files in the same directory, and the actions of the "ERA *.*•• and 
"SAVE" commands have changed. The altered DIR format is 
self-explanatory, while the USER command takes the form: 

USER n 

where n is an integer value in the range to 15. Upon cold start, 
the operator is automatically "logged" into user area number 0, which 
is compatible with standard CP/M 1.4 directories. The operator may 
issue the USER command at any time to move to another logical area 
within the same directory. Drives which are logged-in while 
addressing one user number are automatically active when the operator 
moves to another user numoer since a user number is simply a prefix 
which accesses particular directory entries on the active disks. 

The active user number is maintained until changed by a 
subsequent USER command, or until a cold start operation when user 
is again assumed. 

Due to the fact that user numbers now tag individual directory 
entries, the ERA * . * command has a different effect. In version 1.4, 
this command can be used to erase a directory whicn has "garbage" 
information, perhaps resulting from use of a diskette under another 
operating system (heaven foroid!). In 2.0, however, the ERA *.* 
command affects only the current user numoer. Thus, it is necessary 
to write a simple utility to erase a nonsense disk (the program simply 
writes the hexadecimal pattern E5 throughout the disk). 

The SAVE command in version 1.4 allows only a single memory save 
operation, with the potential of destroying the memory image due to 
directory operations following extent boundary changes. Version 2.0, 
nowever, does not perform directory operations in user data areas 
after disk writes, and thus the SAVE operation can be used any number 
of times without altering the memory image. 
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4. STAT ENHANCEMENTS. 

The STAT program has a number of additional functions which 
allow disk parameter display, user number display/ and file indicator 
manipulation. The command: 

STAT VAL: 

produces a summary of the available status commands, resulting in the 
output: 

Temp R/O Disk: d:=R/0 

Set Indicator: d:f ilename. typ $R/0 $R/tf $SYS $DIR 

Disk Status : DSK: d:DSK: 

User Status : USR: 

Iobyte Assign: 

(list of possible assignments) 

whicn gives an instant summary of the possible STAT commands. The 
command form: 

STAT d:f ilename. typ s?S 

wnere "d:" is an optional drive name, and "filename. typ" is an 

unamoiguous or ambiguous file name, produces the output display 
format: 

Size Recs 3ytes Ext Ace 

4 8 4 8 6k 1 R/0 A: ED. COM 

55 55 12k 1 R/0 (A:PIP.COM) 

65536 128 2k 2 R/W A:X.DAT 

where tne $S parameter causes the "Size" field to be displayed 
(without the $S r the Size field is skipped, but the remaining fields 
are displayed) . The Size field lists the virtual file size in 
records, while the "Recs" field sums the numoer of virtual records in 
each extent. For files constructed sequentially, the Size and Recs 
fields are identical. The "Bytes" field lists the actual number of 
bytes allocated to the corresponding file. The minimum allocation 
unit is determined at configuration time, and thus tne number of bytes 
corresponds to the record count plus the remaining unused space in the 
last allocated olock for sequential files. Random access files are 
given data areas only wnen written, so the Bytes field contains the 
only accurate allocation figure. In the case of random access, the 
Size field gives the logical end-of-file record position and the Recs 
field counts the logical records of each extent (each of these 
extents, however, may contain unallocated "noles" even though they are 
added into the record count). The "Ext" field counts the number of 
logical 16K extents allocated to the file. Unlike version 1.4, the 
Ext count does not necessarily correspond to the number of directory 
entries given to the file, since there can be up to 128K oytes (8 
logical extents) directly addressed by a single directory entry, 
depending upon allocation size (in a special case, there are actually 
256K bytes which can be directly addressed by a physical extent) . 

The "Ace" field gives the R/0 or R/vV access mode, which is 
changed using the commands shown below. Similarly, the parentheses 
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shown around the PIP.COM file name indicate that it has the "system" 
indicator set, so that it will not be listed in DIR commands. The 
four command forms 

STAT d:f ilename. typ i?R/0 
STAT d:f ilename. typ $R/W 
STAT d:f ilename. typ $SYS 
STAT d:f ilename. typ $DIR 

set or reset various permanent file indicators. The R/0 indicator 
places the file (or set of files) in a read-only status until changed 
by a subsequent STAT command. The R/0 status is recorded in the 
directory with tne file so that it remains R/0 through intervening 
cold start operations. The R/W indicator places the file in a 
permanent read/write status. The SYS indicator attaches the system 
indicator to the file, while the DIR command removes the system 
indicator. The "filename. typ" may be ambiguous or unambiguous, but in 
either case, the files whose attributes are changed are listed at the 
console when the change occurs. The drive name denoted by "d:" is 
optional. 

When a file is marked R/0, subsequent attempts to erase or write 
into the file result in a terminal BDOS message 

Bdos Err on d: File R/0 

The BOOS then waits for a console input before performing a subsequent 
warm start (a "return" is sufficient to continue) . The command form 

STAT d:DSK: 

lists the drive characteristics of the disk named by "d:" which is in 
the range A:, B:, ..., P:. The drive characteristics are listed in 
the format: 

d: Drive Characteristics 

65536: 128 Byte record Capacity 

8192: Kilooyte Drive Capacity 

128: 32 Byte Directory Entries 

0: Checked Directory Entries 

1024: Records/ Extent 

128: Records/ Block 

58: Sectors/ Track 

2: Reserved Tracks 

where "d:" is the selected drive, followed by the total record 
capacity (65536 is an 8 megaoyte drive) , followed by the total 
capacity listed in Kilobytes. The directory size is listed next, 
followed by the "checked" entries. The number of checked entries is 
usually identical to the directory size for removable media, since 
this mechanism is used to detect changed media during CP/M operation 
without an intervening warm start. For fixed media, the number is 
usually zero, since the media is not changed without at least a cold 
or warm start. The number of records per extent determines the 
addressing capacity of each directory entry (1024 times 128 bytes, or 
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128K in the example above) . The number of records per block shows the 
basic allocation size (in the example, 128 records/block times 128 
bytes per record, or 16K bytes per block) . The listing is then 
followed by the number of physical sectors oer track and the number of 
reserved tracks. For logical drives which share the same physical 
disk, the number of reserved tracks may be quite large, since this 
mechanism is used to skip lower-numbered disk areas allocated to other 
logical disks. The command form 

STAT DSK: 

produces a drive characteristics table for all currently active 
drives. The final STAT command form is 

STAT USR: 

which produces a list of the user numbers whicn have files on the 
currently addressed disk. The display format is: 

Active User : 
Active Files: 1 3 

where the first line lists the currently addressed user number, as set 
by the last CCP USER command, followed by a list of user numbers 
scanned from the current directory. In the above case, the active 
user number is (default at cold start) , witn three user numbers 
whicn have active files on the current disk. The operator can 
subsequently examine the directories of the other user numbers by 
logging-in with USER 1, USER 2, or USER 3 commands, followed by a DIR 
command at the CCP level. 
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5. PIP ENHANCEMENTS; 

PIP provides three new functions whicn account for the features 
of CP/M 2.0. All three functions take the form of file parameters 
which are enclosed in square brackets following the appropriate file 
names. The commands are: 



Gn 



W 



R 



Get File from User number n 
(n in the range - 15) 

Write over R/0 files without 
console interrogation 

Read system files 



The G command allows one user area to receive data files from another. 
Assuming the operator has issued the USER 4 command at the CCP. level, 
the PIP statement 

PIP X.Y = X.Y[G2] 

reads file X.Y from user number 2 into user area number 4. The 
command 

PIP A:=A:*.*[G2] 

copies all of the tiles from the A drive directory for user number 2 
into the A drive directory of the currently logged user number. Note 
that to ensure file security, one cannot copy files into a different 
area tnan the one which is currently addressed by the USER command. 

Note also that the PIP program itself is initially copied to a 
user area (so that subsequent files can be copied) using the SAVE 
command. The sequence of operations shown below effectively moves PIP 
from one user area to the next. 

USER login user d 

DDT PIP.COM load PIP to memory 

(note PIP size s) 

G0 return to CCP 

USER 3 login user 3 
SAVE s PIP.COM 

where s is the integral number of memory "pages" (256 byte segments) 
occupied by PIP. The number s can be determined when PIP.COM is 
loaded under DDT, by referring to the value under the "NEXT" display. 
If for example, the next available address is 1D00, then PIP.COM 
requires 1C hexadecimal pages (or 1 times 16 + 12 = 28 pages) , and 
thus the value of s is 28 in the subsequent save. Once PIP is copied 
in this manner, it can then be copied to another disk belonging to the 
same user number through normal pip transfers. 

Under normal operation, PIP will not overwrite a file which is 
set to a permanent R/0 status. If attempt is made to overwrite a R/0 
file, the prompt 



(All Information Contained Herein is Proprietary to Digital Research.) 

8 



OFSTINATION FILE IS R/O, DELETE (Y/N)? 

is issued. If the operator responds with the character "y" then the 
file is overwritten. Otherwise, the response 

** NOT DELETED ** 

is issued, the file transfer is skippped, and PIP continues with the 
next operation in sequence. In order to avoid the prompt and response 
in the case of R/O file overwrite, the command line can include the W 
parameter, as shown below 

PIP A:=3:*.COM[W] 

which copies all non-system files to. the A drive from the B drive, and 
overwrites any R/0 files in the process. If the operation involves 
several concatenated files, the W parameter need only be included with 
the last file in the list, as shown in the following example 

PIP A. DAT = B.DAT,F:NEW.DAT,G:OLD.DAT[W] 

Files with the system attribute can be included in PIP transfers 
if the R parameter is included, otherwise system files are not 
recognized. The command line 

PIP ED.COM = 3 : ED. COM [R] 

for example, reads the ED.COM file from the B drive, even if it has 
been marked as a R/O and system file. The system file attributes are 
copied, if present. 



It should be noted that downward compatibility with previous 
versions of CP/M is only maintained if the file does not exceed one 
megabyte, no file attributes are set, and the file is created by user 
0. If compatibility is required with non-standard (e.g., "double 
density") versions of 1.4, it may be necessary to select 1.4 
compatibility mode when constructing the internal disk parameter block 
(see the "CP/M 2.0 Alteration Guide," and refer to Section 10 which 
describes BIOS differences) . 
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6. ED ENHANCEMENTS. 

The CP/M standard orogram editor provides several new facilities 
in the 2.0 release. Experience has shown that most operators use the 
relative line numbering feature of ED, and thus the editor has the "V 
(Verify Line) option set as an initial value. The operator can, of 
course, disable line numbering by typing the "-v" command. If you are 
not familiar with the ED line number mode, you may wish to refer to 
the Appendix in the ED user's guide, where the "v" command is 
described. 

ED also takes file attributes into account. If the operator 
attempts to edit a read/only file, the message 

** FILE IS READ/ONLY ** 

appears at the console. The file can be loaded and examined, but 
cannot be altered in any way. Normally, the operator simply ends the 
edit session, and uses STAT to change the file attribute to R/W. If 
the edited file has the "system" attribute set, the message 

"SYSTEM" FILE NOT ACCESSIBLE 



is displayed at the console, 
the STAT program can be 
desired. 



and the edit session is aborted. Again, 
used to change the system attribute, if 



Finally, the insert mode ("i") command allows CRT 
functions, as described in Section 2, above. 



line editing 
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7. THE XSUB FUNCTION. 

An additional utility program is supplied with version 2.0 of 
CP/M, called XSUB, which extends the power of the SUBMIT facility to 
include line input to programs as well as the console command 
processor. The XSUB command is included as the first line of your 
submit file and r when executed, self-relocates directly below the CCP. 
All subsequent submit command lines are processed by XSUB r so that 
programs which read buffered console input (BDOS function 10) receive 
their input directly from the submit file. For example, the file 
SAVER. SUB could contain the submit lines: 

XSUB 

DDT 

I$1.HEX 

R 

G0 

SAVE 1 $2. COM 

with a subsequent SUBMIT command: 

SUBMIT SAVER X Y 

which substitutes X for $1 and Y for $2 in the command stream. The 
XSUB program loads, followed by DDT which is sent the command lines 
"IX. HEX" "R" and "G0" thus returning to the CCP. The final command 
"SAVE 1 Y.COM" is processed by the CCP. 

The XSUB program remains in memory, and prints the message 

(xsub active) 

on each warm start operation to indicate its presence. Subsequent 
submit command streams do not reauire the XSUB, unless an intervening 
cold start has occurred. Note that XSUB must be loaded after DESPOOL, 
if both are to run simultaneously. 
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8. BDOS INTERFACE CONVENTIONS. 



CP/M 2.0 system calls take place in exactly the same manner as 
earlier versions, with a call to location 0005H, function number in 
register C, and information address in register pair DE. Single byte 
values are returned in register A, with double byte values returned in 
HL (for reasons of compatibility, register A =• L and register B = H 
upon return in all cases). A list of CP/M 2.0 calls is given below, 
with an asterisk following functions which are either new or revised 
from version 1.4 to 2.0. Note that a zero value is returned for 
out-of range function numbers. 





1 

2 

3 

4 

5 

6* 

7 

8 

9 
10* 
11 
12* 
13 
14 
15* 
16 
17* 
18* 



System Reset 

Console Input 

Console Output 

Reader Input 

Puncn Output 

List Output 

Direct Console I/O 

Get I/O Byte 

Set I/O Byte 

Print String 

Read Console Buffer 

Get Console Status 

Return Version Number 

Reset Disk System 

Select Disk 

Open File 

dose File 

Search for First 

Search for Next 



19* 

20 

21 

22* 

23* 

24* 

25 

26 

27 

28* 

29* 

30* 

31* 

32* 

33* 

34* 

35* 

36* 



Delete File 
Read Sequential 
Write Sequential 
Make File 
Rename File 
Return Login Vector 
Return Current Disk 
Set DMA Address 
Get Addr (Alloc) 
Write Protect Disk 
Get Addr(R/0 Vector) 
Set File Attributes 
Get Addr(Disk Parms) 
Set/Get User Code 
Read Random 
Write Random 
Comoute File Size 
Set Random Record 



(Functions 2b, 29, and 32 should be avoided in application programs to 
maintain upward compatibility with MP/M.) The new or revised functions 
are described below. 



Function 6: Direct Console I/O. 

Direct Console I/O is supported under CP/M 2.0 for those 
applications where it is necessary to avoid the BDOS console I/O 
operations. Programs whicn currently perform direct I/O through the 
BIOS should be changed to use direct I/O under BDOS so that they can 
be fully supported under future releases of MP/M and CP/M. 

Upon entry to function 6 , register E eitner contains hexadecimal 
FF, denoting a console input request, or register E contains an ASCII 
cnaracter. If the input value is FF, then function 6 returns A = 00 
if no character is ready, otherwise A contains the next console input 
character. 

If the input value in E is not FF, then function 6 assumes that 
E contains a valid ASCII character which is sent to the console. 
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Function 10: Read Console Buffer. 

The console buffer read operation remains unchanged except that 
console line editing is supported, as described in Section 2. Note 
also that certain functions which return the carriage to the leftmost 
position (e.g. r ctl-X) do so only to the column position where the 
prompt ended (previously, the carriage returned to the extreme left 
margin) . This new convention makes operator data input and line 
correction more legible. 



Function 12: Return Version Number. 

Function 12 has been redefined to orovide information which 
allows version-independent programming (this was previously the "lift 
head" function whicn returned HL=0000 in version 1.4, but performed no 
operation) . The value returned by function 12 is a two-byte value, 
with H = 00 for the CP/M release (H = 01 for MP/M) , and L = 00 for all 
releases previous to 2.0. CP/M 2.0 returns a hexadecimal 20 in 
register L, with subsequent version 2 releases in the hexadecimal 
range 21, 22, through 2F. Using function 12, for example, you can 
write application programs which provide both sequential and random 
access functions, with random access disabled when operating under 
early releases of CP/M. 

In the file operations described below, DE addresses a file 
control block (FCB) . Further, all directory operations take place in 
a reserved area which does not affect write buffers as was the case in 
version 1.4, with the exception of Searcn First and Search Next, where 
compatibility is required. 

The File Control Block (FCB) data area consists of a sequence of 33 
bytes for sequential access, and a series of 36 bytes in the case that 
the file is accessed randomly. The default file control block 
normally located at 005CH can be used for random access files, since 
bytes 007DH, 007EH, and 007FH are available for this purpose. For 
notational purposes, the FCB format is shown with the following 
fields : 
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Idr|fl|f2|/ / I f8 | tl 1 12 1 13 [ex| si I s2 I rcl d0 ! / / I dn 1 cr I r0 I rl I r 2 I 

00 01 02 ... 08 09 10 11 12 13 14 15 16 ... 31 32 33 34 35 



where 



dr drive code (0 - 16) 

=> use default drive for file 

1 => auto disk select drive A, 

2 => auto disk select drive B r 

• • • 

16=> auto disk select drive P. 

fl...f8 contain the file name in ASCII 
upper case, with high 'bit = 

tl,t2,t3 contain the file type in ASCII 
upper case, with high bit = 
tl * , t2*, and t3' denote the 
bit of these positions, 
tl' = 1 => Read/Only file, 
t2* = 1 => SYS file, no DIR list 

ex contains the current extent number, 
normally set to 00 by the user, but 
in range 0-31 during file I/O 

si reserved for internal system use 

s2 reserved for internal system use, set 
to zero on call to OPEN, MAKE, SEARCH 

re record count for extent "ex," 
takes on values from - 128 

d0...dn filled-in by CP/M, reserved for 
system use 

cr current record to read or write in 

a sequential file operation, normally 
set to zero by user 

r0,rl,r2 optional random record number in the 
range 0-65535, with overflow to r2, 
r0,rl constitute a 16-bit value with 
low byte r0, and high byte rl 



Function 15: Open File. 

Tne Open File operation is identical to previous definitions, 
with the exception that byte s2 is automatically zeroed. Note that 
previous versions of CP/M defined this byte as zero, but made no 
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cnecks to assure compliance. Thus, the byte is cleared to ensure 
upward compatibility with the latest version, where it is required. 



Function 17: Search for First. 

Search First scans the directory for a match with the file given 
by the FCB addressed by DE. The value 255 (hexadecimal FF) is 
returned if the file is not found, otherwise a value of A equal to 0, 
l f 2, or 3 is returned indicating the file is present. In the case 
that the file is found, the current DMA address is filled with the 
record containing the directory entry, and the relative starting 
position is A * 32 (i.e., rotate the A register left 5 bits, or ADD A 
five times). Although not normally required for application programs, 
the directory information can be extracted from the buffer at this 
position. 

An ASCII question mark (63 decimal, 3F hexadecimal) in any 
position from fl through ex matches the corresponding field of any 
directory entry on the default or auto-selected disk drive. If the dr 
field contains an ASCII question mark, then the auto disk select 
function is disabled, the default disk is searched, with the search 
function returning any matched entry, allocated or free, belonging to 
any user number. This latter function is not normally used by 
application programs, out does allow complete flexibility to scan all 
current directory values. If the dr field is not a question mark, the 
s2 byte is automatically zeroed. 



Function 18: Search for Next. 



The Search Next function is similar to the Search First 
function, except that the directory scan continues from the last 
matched entry. Similar to function 17, function 18 returns the 
decimal value 255 in A when no more directory items match. 



Function 19: Delete File. 

The Delete File function removes files which match the FCB 
addressed by DE. The filename and type may contain ambiguous 
references (i.e., question marks in various positions), but the drive 
select code cannot be ambiguous, as in the Search and Search Next 
functions. 

Function 19 returns a decimal 255 if the reference file or files 
could not be found, otherwise a value in the range to 3 is returned. 
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Function 22: Make File. 

The Make File operation is identical to previous versions of 
CP/M, except that byte s2 is zeroed upon entry to the 3D0S. 



Function 23: Rename File. 

The Actions of the file rename functions are the same as 
previous releases except that the value 255 is returned if the rename 
function is unsuccessful (the file to rename could not be found) , 
otherwise a value in the range to 3 is returned. 



Function 24: Return Login Vector. 

The login vector value returned by CP/M 2.0 is a 16-bit value in 
HL, where the least significant bit of L corresponds to the first 
drive A, and the high order bit of H corresponds to the sixteenth 
drive, labelled P. Note that compatibility is maintained with earlier 
releases, since registers A and L contain the same values upon return. 



Function 28: Write Protect Current Disk. 

The disk write protect function provides temporary write 

protection for the currently selected disk. Any attempt to write to 

the disk, before the next cold or warm start operation produces the 
message 

Bdos Err on d: R/0 



Function 29: Get R/0 Vector. 

Function 29 returns a bit vector in register pair HL which 
indicates drives which have the temporary read/only bit set. Similar 
to function 24, the least significant Pit corresponds to drive A, 
while the most significant bit corresponds to drive P. The R/0 bit is 
set either by an explicit call to function 28, or by the automatic 
software mechanisms within CP/M whicn detect changed disks. 



Function 30: Set File Attributes. 

The Set File Attributes function allows programmatic 
manipulation of permanent indicators attached to files. In 
particular, the R/0 and System attributes (tl* and t2* above) can be 
set or reset. The D£ pair addresses an unambiguous file name with the 
appropriate attributes set or reset. Function 30 searches for a 
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match, and chanqes the matched directory entry to contain the selected 
indicators. Indicators fl* through f4' are not presently used, but 
may be useful for applications programs, since they are not involved 
in the matching process during file open and close operations. 
Indicators f5* tnrough f3* and t3' are reserved for future system 
expansion. 



Function 31: Get Disk Parameter Block Address. 

The address of the BIOS resident disk parameter block is 
returned in HL as a result of this function call. This address can be 
used for either of two purposes. First, the disk parameter values can 
be extracted for display and space computation purposes, or transient 
programs can dynamically change the values of current disk parameters 
when the disk environment changes, if required. Normally, application 
programs will not require this facility. 



Function 32: Set or Get User Code. 

An application program can change or interrogate the currently 
active user number oy calling function 32. If register E = FF 
nexaciecimal, tnen tne value of the current user number is returned in 
register A, where the value is in the range to 31. If register E is 
not FF, then the current user number is changed to the value of E 
(modulo 32) . 



Function 33: Read Random. 

The Read Random function is similar to the sequential file read 
operation of previous releases, except that the read operation takes 
place at a particular record number, selected by the 24-bit value 
constructed from the three byte field following the FCB (byte 
positions r0 at 33, rl at 34, and r2 at 35). Note that the sequence 
of 24 bits is stored with least significant byte first (r0) , middle 
oyte next (rl) , and high byte last (r2) . CP/M release 2.0 does not 
reference byte r2, except in computing the size of a file (function 
35). Byte r2 must be zero, however, since a non-zero value indicates 
overflow past the end of file. 

Thus, in version 2.0, the r0,rl byte pair is treated as a 
double-byte, or "word" value, which contains the record to read. This 
value ranges from to 65535, providing access to any particular 
record of the 8 megabyte file. In order to orocess a file using 
random access, the base extent (extent 0) must first be opened. 
Altnough the case extent may or may not contain any allocated data, 
this ensures that the file is properly recorded in the directory, and 
is visible in DIR requests. The selected record number is then stored 
into the random record field (r0,rl), and the BDOS is called to read 
the record. Upon return from the call, register A either contains an 
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error code, as listed below, or the value 00 indicating the operation 
was successful. In the latter case, the current DMA address contains 
the randomly accessed record, Note that contrary to the sequential 
read operation, the record number is not advanced. Thus, subsequent 
random read operations continue to read the same record. 

Upon each random read operation, the logical extent and current 
record values are automatically set. Thus, the file can be 
sequentially read or written, starting from the current randomly 
accessed position. Note, however, that in this case, the last 
randomly read record will be re-read as you switch from random mode to 
sequential read, and the last record will be re-written as you switch 
to a sequential write operation. You can, of course, simply advance 
the random record position following each random read or write to 
obtain the effect of a sequential I/O operation. 

Error codes returned in register A following a random read are 
listed below. 

01 reading unwritten data 

02 (not returned in random mode) 

03 cannot close current extent 

04 seek to unwritten extent 

05 (not returned in read mode) 

06 seek past physical end of disk 

Error code 01 and 04 occur when a random read operation accesses a 
data block which has not been previously written, or an extent which 
has not been created, which are equivalent conditions. Error 3 does 
not normally occur under proper system operation, but can be cleared 
by simply re-reading, or re-opening extent zero as long as the disk is 
not physically write protected. Error code 06 occurs whenever byte r2 
is non-zero under the current 2.0 release. Normally, non-zero return 
codes can oe treated as missing data, with zero return codes 
indicating operation complete. 



Function 34: Write Random. 

The Write Random operation is initiated similar to the Read 
Random call, except that data is written to the disk from the current 
DMA address. Further, if the disk extent or data block which is the 
target of the write has not yet been allocated, the allocation is 
performed before the write operation continues. As in the Read Random 
operation, the random record number is not changed as a result of the 
write. The logical extent number and current record positions of the 
file control block are set to correspond to the random record which is 
being written. Again, sequential read or write operations can 
commence following a random write, with the notation that the 
currently addressed record is either read or rewritten again as the 
sequential operation begins. You can also simply advance the random 
record position following each write to get the effect of a sequential 
write operation. Note that in particular, reading or writing the last 
record of an extent in random mode does not cause an automatic extent 
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switch as it does in sequential mode under either CP/M 1.4 or CP/M 
2.0. 

The error codes returned by a random write are identical to the 
random read operation with the addition of error code 05 , which 
indicates that a new extent cannot be created due to directory 
overflow. 



Function 35: Compute File Size. 

When computing the size of a file, the DE register pair 
addresses an FCB in random mode format (bytes r0, rl, and r2 are 
present). The FCB contains an unambiguous file name which is used in 
the directory scan. Upon return, the random record bytes contain the 
"virtual" file size which is, in effect, the record address of the 
record following the end of the file. if, following a call to 
function 35, the high record byte r2 is 01, then the file contains the 
maximum record count 65536 in version 2.0. Otherwise, bytes r0 and rl 
constitute a 16-bit value (r0 is the least significant byte, as 
before) which is the file size. 

Data can be appended to the end of an existing file by simply 
calling function 35 to set the random record position to the end of 
file, tnen performing a sequence of random writes starting at the 
preset record address. 

The virtual size of a file corresponds to the physical size when 
the file is written sequentially. If, instead, the file was created 
in random mode and "holes" exist in the allocation, then the file may 
in fact contain fewer records than the size indicates. If, for 
example, only the last record of an eight megabyte file is written in 
random mode (i.e. , record number 65535) , then the virtual size is 
65536 records, although only one block of data is actually allocated. 



Function 36: Set Random Record. 

The Set Random Record function causes the BDOS to automatically 
produce the random record position from a file which has been read or 
written sequentially to a particular point. The function can be 
useful in two ways. 

First, it is often necessary to initially read and scan a 
sequential file to extract the positions of various "key" fields. As 
each key is encountered, function 36 is called to compute the random 
record position for the data corresponding to this key. If the data 
unit size is 128 bytes, the resulting record position is placed into a 
table with the key for later retrieval. After scanning the entire 
file and tabularizing the keys and their record numbers, you can move 
instantly to a particular keyed record by performing a random read 
using the corresponding random record number which was saved earlier. 
The scheme is easily generalized when variable record lengths are 
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involved since the program need only store the buffer-relative byte 
position along with the key and record number in order to find the 
exact starting position of the keyed data at a later time. 

A second use of function 36 occurs when switching from a 
sequential read or write over to random read or write. A file is 
sequentially accessed to a particular point in the file, function 36 
is called which sets the record number, and subsequent random read and 
write operations continue from the selected point in the file. 



This section is concluded with a rather extensive, but complete 
example of random access operation. The program listed below performs 
the simple function of reading or writing random records upon command 
from the terminal. Given that the program has been created, 
assembled, and placed into a file labelled RANDOM.COM, the CCP level 
command: 

RANDOM X.DAT 

starts the test program. The program looks for a file by the name 
X.DAT (in this particular case) and, if found, proceeds to prompt the 
console for input. If not found, the file is created before the 
prompt is given. Each prompt takes the form 

next command? 

and is followed by operator input, terminated by a carriage return. 
The input commands take the form 

nw nR Q 

where n is an integer value in the range to 65535, and W, R, and Q 
are simple command characters corresponding to random write, random 
read, and quit processing, respectively. If the W command is issued, 
the RANDOM program issues the prompt 

type data: 

The operator then responds by typing up to 127 characters, followed by 
a carriage return. RANDOM then writes the character string into the 
X.DAT file at record n. If the R command is issued, RANDOM reads 
record number n and displays the string value at the console. If the 
Q command is issued, the X.DAT file is closed, and the program returns 
to the console command processor. In the interest of brevity (ok, so 
the program's not so brief), the only error message is 

error, try again 

The program begins with an initialization section where the 
input file is opened or created, followed by a continuous loop at the 
label "ready" where the individual commands are interpreted. The 
default file control block at 005CH and the default buffer at 0080H 
are used in all disk operations. The utility subroutines then follow, 
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which contain the principal input line processor, called "readc." 

This particular program shows the elements of random access 

processing, and can be used as the basis for further program 
development. 



0100 



. ********************** 
. * 

;* sample random access 
. * 

. ********************** 
org 100h 



0100 31bc0 



0103 0e0c 

0105 cd050 

0108 fe20 

010a d2160 

010d lllb0 

0110 cdda0 

0113 C3000 



***************************** 

* 

program for cp/m 2.0 * 

* 

***************************** 
base of toa 



system reboot 
bdos entry point 

console input function 
console output function 
print string until '$' 
read console buffer 
return version number 
file open function 
close function 
make file function 
read random 
write random 

default file control block 
random record position 
high order (overflow) byte 
buffer address 

carriage return 
line feed 



*************************************************** 

* * 

* load SP, set-up file for random access * 

* * 

*************************************************** 
lxi sp r stack 

version 2.0? 

mvi c r version 

call bdos 

cpi 20h ;version 2.0 or better? 

jnc versok 

bad version, message and go back 

lxi d,badver 

call orint 

jmo reboot 



0000 


= 


reboot 


equ 


0000h 


0005 


= 


bdos 


equ 


0005h 


0001 


= 


coninp 


equ 


1 


0002 


= 


conout 


equ 


2 


0009 


= 


pstring 


equ 


9 


000a 


= 


rstring 


equ 


10 


000C 


= 


version 


equ 


12 


000f 


= 


openf 


equ 


15 


0010 


= 


closef 


equ 


16 


0016 


= 


makef 


equ 


22 


0tf21 


= 


readr 


equ 


33 


0022 


= 


wr iter 


eau 


34 


005c 


= 


fCD 


equ 


5ch 


007d 


= 


ranrec 


equ 


fcb+33 


7f 


= 


ranovf 


equ 


fcb+35 


0080 


= 


buff 


equ 


0080h 


000d 


= 


cr 


equ 


0dh 


000a 


= 


If 


equ 


0ah 



versok : 



correct version for random access 
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0116 


0e0£ 


0118 


115c0 


011b 


cd050 


011e 


3c 


011f 


C2370 


0122 


0el6 


0124 


115c0 


0127 


cd050 


012a 


3c 


012b 


C2370 


012e 


113a0 


0131 


cdda0 


0134 


C3000 



mvi c r openf ;open default fcb 

lxi d f fcb 

call bdos 

inr a ;err 255 becomes zero 

jnz ready 

cannot open file, so create it 

mvi c,makef 

lxi d r fcb 

call bdos 

inr a ;err 255 becomes zero 

jnz ready 

cannot create file, directory full 

lxi d,nospace 

call print 

jmp reboot ;back to ccp 

*************************************************** 

* * 

* loop back to "ready" after each command * 

* * 

*************************************************** 



ready: 



file is ready for processing 



0137 


cde50 


call 


013a 


227d0 


snld 


013d 


217f0 


lxi 


0140 


3600 


mvi 


0142 


fe51 


cpi 


0144 


C2560 


jnz 




• 


quit 


0147 


0el0 


mvi 


0149 


115c0 


lxi 


014c 


cd050 


call 


014f 


3c 


inr 


0150 


cab90 


jz 


0153 


C3000 


jmo 



0156 fe57 
0158 c2890 



015b 114d0 
015e cdda0 



readcom ;read next command 

ranrec ;store input record# 

h,ranovf 

m,0 yclear high byte if set 

•Q* ;quit? 

notq 



quit processing, close file 
c,closef 
d,fcb 
bdos 

a ;err 255 becomes 
error ;error message, retry 
reboot ;back to ccp 

*************************************************** 

* * 

* end of quit command, process write * 

* * 

*************************************************** 

notq: 

; not the quit command, random write? 

cp i • W * 

jnz notw 

; this is a random write, fill buffer until cr 
lxi d,datmsg 
call print ;data prompt 
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0161 


0e7f 


0163 


21800 


0166 


c5 


0167 


e5 


0168 


cdc20 


016b 


el 


016c 


cl 


016d 


fe0d 


016f 


ca780 


0172 


77 


0173 


23 


0174 


0d 


0175 


C2660 



0178 3600 



017a 


0e22 


017c 


115c0 


017f 


cd050 


0182 


b7 


0183 


c2b90 


0186 


c3370 



0189 fe52 
018b c2b90 



018e 0e21 
0190 115c0 
0193 cd050 
019 6 b7 
0197 c2b90 



019a cdcf0 
019d 0e80 
019f 21800 

01a2 7e 
01a3 23 
01a4 e67f 
01a6 ca370 
01a9 c5 
01aa e5 



rloop: 



erloop 



mvi 

lxi 

; read 

push 

push 

call 

pop 

pop 

cpi 

jz 

not 

mov 

inx 

dcr 

jnz 



n 



end 



c,127 

h, buf f 
ext cha 

b 

h 

getchr 

n 

b 

cr 

erloop 
, store 

m,a 

h 

c 

rloop 



;up to 127 characters 
destination 
racter to buff 
;save counter 
;next destination 
;character to a 
;restore counter 
jrestore next to fill 
;end of line? 

character 

;next to fill 
;counter goes down 
;end of buffer? 



end of read loop, store 00 
mvi m,0 



write 

mvi 

lxi 

call 

ora 

jnz 

jmp 



the record to selected record number 
c, writer 
d,fcb 



bdos 
a 

error 
ready 



;error code zero? 
;message if not 
;for another record 



*************************************************** 

* * 

* end of write command, orocess read * 

* * 

*************************************************** 

notw: 

; not a write command, read record? 

cpi * R* 

jnz error ;skip if not 

; read random record 
mvi creadr 
lxi d r fcb 
call bdos 

ora a ;return code 00? 
jnz error 

; read was successful, write to console 
call crlf ?new line 

;max 128 characters 
h,buff ;next to get 



wloop: 



mvi 


c,128 


lxi 


h,buf 


mov 


a,m 


inx 


h 


ani 


7fh 


jz 


ready 


push 


b 


push 


h 



;next character 

;next to get 

;mask parity 

;for another command if 00 

ysave counter 

;save next to get 
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01ab fe20 
01ad d4c30 
01b0 el 
01bl cl 
01b2 0d 
01b3 c2a20 
01b6 C3370 



cpi ;graphic? 

cnc putchr ;skip output if not 

pop n 

pop b 

dcr c ;count=count-l 

jnz wloop 

jmp ready 

*************************************************** 

* * 

* end of read command, all errors end-uo here * 

* * 

*************************************************** 







error: 






01b9 


11590 




lxi 


d ,er rmsg 


01bc 


cdda0 




call 


print 


01bf 


C3370 




J m P 


ready 



01c2 0e01 
01c4 cd050 
01c7 c9 



*************************************************** 

* * 

* utility subroutines for console i/o * 

* * 

*************************************************** 

qetchr : 

;read next console character to a 
mvi c,coninp 
call bdos 
ret 



01c8 0e02 
01ca 5f 
01cb cd050 
01ce c9 



putchr : 



;write character from a to console 

mvi c r conout 

mov e,a ^character to send 

call bdos ;send character 

ret 



crlf : 



01cf 3e0d 

01dl cdc80 

01d4 3e0a 

01d6 cdc80 

01d9 c9 



;send carriage return line feed 

mvi a,cr ;carriage return 

call putchr 

mvi a, If ;line feed 

call putchr 

ret 



pr int: 



01da d5 
01db cdcf0 
01de dl 
01df 0e09 
01el cd050 
01e4 c9 



;print the buffer addressed by de until $ 

push d 

call crlf 

pop d ;new line 

mvi cpstring 

call bdos ;print the string 

ret 



readcom: 
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01e5 
01e8 
01eb 
01ed 
01f0 

01f3 
01f6 
01f9 
01fa 
01fb 
01fc 

01fd 
01ff 
0201 

0204 
0205 
0206 
0207 
0208 
0209 
020a 
2#o 
020c 
020f 
0210 



0213 
0215 
0217 

0218 
021a 



116b0 

cdda0 

0e0a 

117a0 

cd050 

21000 

117c0 

la 

13 

b7 

c8 

d630 
fe0a 
d2130 

29 

4d 

44 

29 

29 

09 

85 

bi 

d2f90 

24 

c3f90 



c630 
fe61 
d8 

e65f 
c9 



reaac 



endrd 



;read the next command line to the conbuf 

lxi d, prompt 

call print ; command? 

mvi c,r string 

lxi d,conbuf 

call bdos ;read command line 

command line is present, scan it 

lxi h,0 ;start with 0000 

lxi d ,conlin;command line 

ldax d ;next command character 

inx d ;to next command position 

ora a ; cannot be end of command 

rz 

not zero, numeric? 

sui '0* 

cpi 10 ;carry if numeric 

jnc endrd 

add-in next digit 

dad 

mov 

mov 

dad 

dad 

dad 

add 

mov 

jnc 

inr 

jmp 

end of read, restore value in a 

adi '0* ; command 

cpi 'a' ;translate case? 

re 

lower case, mask lower case bits 

ani 101$llllb 

ret 



h 


;*2 


c,l 




b, h 


;bc = value * 2 


h 


;*4 


h 


;*8 


b 


;*2 + *8 = *10 


1 


;+digit 


Ira 




readc 


;for another char 


h 


; over flow 


readc 


;for another char 



021b 
023a 
024d 
0259 
026b 



******** ******************************************* 
* * 

* 
* 
*************************************************** 

badver : 

•sorry, you need cp/m version 2$' 



* string data area for console messages 
* 



536f79 db 

nospace: 
4e6f29 db 

datmsg : 
547970 db 

errmsg : 
457272 db 

prompt: 
4e6570 db 



'no directory space$ ' 
' type data: $• 
'error, try again. $' 
'next command? $' 
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027a 


21 


conbuf : 


db 


027b 




consiz: 


ds 


027c 




conlin: 


ds 


0021 


= 


conlen 


equ 


029c 




stack: 


ds 


2bc 






end 



*************************************************** 

* * 

* fixed and variable data area * 

* * 

*************************************************** 

conlen ;length of console buffer 
1 ; resulting size after read 
32 ;length 32 buffer 
$-consiz 



32 



;16 level stack 
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9. CP/M 2.0 MEMORY ORGANIZATION. 

Similar to earlier versions, CP/M 2.0 is field-altered to fit 
various memory sizes, depending upon the host computer memory 
configuration. Typical base addresses for popular memory sizes are 
shown in the table below. 



Module 


20k 


24k 


32k 


48k 


64k 


CCP 


3400H 


4400H 


6400H 


A400H 


E400H 


BDOS 


3C00H 


4C00H 


6C00H 


AC00H 


EC00H 


BIOS 


4A00H 


5A00H 


7A0 0H 


3A00H 


FA0 0H 


Top of Ram 


4FFFH 


5FFFH 


7FFFH 


BFFFH 


FFFFH 



The distribution disk contains a CP/M 2.0 system configured for a 20k 
Intel MDS-800 with standard ISM 8" floppy disk drives. The disk 
layout is shown below: 



Sector 


Track 


00 


Module 


Track 


01 


Module 


1 


(Bootstrap Loader) 


4080H 


BDOS 


+ 


480H 


2 


3400H 


CCP 


+ 


000H 


4100H 


BDOS 


+ 


500H 


3 


3480H 


CCP 


+ 


080H 


4180H 


BDOS 


+ 


580H 


4 


3500H 


CCP 


+ 


100H 


4200H 


BDOS 


+ 


600H 


5 


3580H 


CCP 


+ 


180H 


4280H 


BDOS 


+ 


680H 


6 


3600H 


CCP 


+ 


200H 


4300H 


BDOS 


+ 


700H 


7 


3680H 


CCP 


+ 


280H 


4380H 


BDOS 


+ 


780H 


8 


3 7 0H 


CCP 


+ 


300H 


4400H 


BDOS 


+ 


800H 


9 


3780H 


CCP 


+ 


380H 


4480H 


BDOS 


+ 


880H 


10 


3 800H 


CCP 


+ 


400H 


4500H 


BDOS 


+ 


900H 


11 


3880H 


CCP 


+ 


480H 


4580H 


BDOS 


+ 


98 0H 


12 


3900H 


CCP 


+ 


500H 


4600H 


BDOS 


+ 


A00H 


13 


3980H 


CCP 


+ 


580H 


4680H 


BDOS 


+ 


A80H 


14 


3A00H 


CCP 


+ 


600H 


4700H 


BDOS 


+ 


B0 0H 


15 


3A80H 


CCP 


+ 


680H 


4780H 


BDOS 


+ 


B8 0H 


16 


3B00H 


CCP 


+ 


700H 


4800H 


BDOS 


+ 


C00H 


17 


3B80H 


CCP 


+ 


780H 


4880H 


BDOS 


+ 


C80H 


18 


3C00H 


BDOS 


+ 


0H 


4900H 


BDOS 


+ 


D00H 


19 


3C80H 


BDOS 


+ 


080H 


4980H 


BDOS 


+ 


D80H 


20 


3D00H 


BDOS 


+ 


100H 


4A00H 


BIOS 


+ 


000H 


21 


3D80H 


BDOS 


+ 


180H 


4A80H 


BIOS 


+ 


080H 


22 


3E00H 


BDOS 


+ 


200H 


4B00H 


BIOS 


+ 


100H 


23 


3E80H 


BDOS 


+ 


280H 


4B80H 


BIOS 


+ 


180H 


24 


3F00H 


BDOS 


+ 


300H 


4C00H 


BIOS 


+ 


200H 


25 


3F80H 


BDOS 


+ 


380H 


4C80H 


BIOS 


+ 


280H 


26 


4000H 


BDOS 


+ 


400H 


4D00H 


BIOS 


+ 


300H 



is at the same position 
as 



In particular, note that the CCP 

and occupies the same space 

however, occupies one more 256-byte 

through the remainder of track 

decimal) bytes in length, the BDOS 

length, and the BIOS is up to 380H 

version 2.0, the BIOS portion contains the standard subroutines 

1.4, along with some initialized table space, as described in 

following section. 



on the disk, 
version 1.4. The BDOS portion, 
page and the BIOS portion extends 
01. Thus, the CCP is 800H (2048 
is E00H (3584 decimal) bytes in 
(898 decimal) bytes in length. 



In 
of 
the 



(All Information Contained Herein is Proprietary to Digital Research.) 

27 



10. 3103 DIFFERENCES. 



The CP/M 2.0 Basic I/O System differs only slightly in concept 
from its predecesssors. Two new jump vector entry points are defined, 
a new sector translation subroutine is included, and a disk 
characteristics table must be defined. The skeletal form of these 
changes are found in the program shown below. 



1 

2 

3 

4 

5 

6 

7 

8 

9 

10 

11 

12 

13 

14 

15 

16 

17 

18 

19 

20 

21 

22 

23 

24 

25 

26 

27 

28 

29 

30 

31 

32 

33 

34 

35 

36 

37 

38 

1 Q 

_» -/ 

40 
41 
42 
43 
44 
45 
46 
47 



bpo 
rpb 
maxb 



boot: 



seldsk: 



selsec: 



org 4000h 
maclio diskdef 
jmp boot 



3mp 

jmp 

disks 

large 

egu 

equ 

equ 

diskdef 

diskdef 

diskdef 

diskdef 

ret 



;list status 
;sector translate 



listst 
sectran 
4 
capacity drive 

16*1024 ;bytes per block 
bpb/128 ; records per block 
65535/rpb ;max block number 
, 1 , 5 8 , 3 , bpb , ma x b+1 , 1 2 8 , , 2 
1,1,58, ,bpb,maxb+l,128,0,2 
2,0 
3,1 



listst: xra 
ret 



;nop 
a 



;nop 



;dr ive 

lxi 

mov 

cpi 

rnc 

proper 

mov 

dad 

dad 

dad 

dad 

lxi 

dad 

ret 



number in c 
h,0 ;0000 in hi produces select error 
a,c ;a is disk number ... ndisks-1 
ndisks ;less than ndisks? 

;return with HL = 0000 if not 
number, return dpb element address 



disk 
l,c 
h 
h 
h 
h 
d,dpbase 



*2 
*4 
*8 
*16 



;HL=.dpb 



; sector 
lxi 
mov 
ret 



number in c 
h, sector 
m,c 



sectran: 



;translate sector BC. using table at DE 

xchg ;HL = .tran 

dad b ;single precision tran 
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48: 




dad b again 


49: 




mov l,m 


50: 




fill botn H 


51: 




ret 


52: 






53: 


sector: 


ds 1 


54: 




endef 


55: 




end 



if double precision tran 

;only low byte necessary here 
and L if double precision tran 

;HL = ??ss 



Referring to the program shown above, lines 3-6 represent the 
8I0S entry vector of 17 elements (version 1.4 defines only 15 jump 
vector elements) . The last two elements provide access to the 
"LISTST" (List Status) entry point for DESPOOL. The use of this 
particular entry point is defined in the DESPOOL documentation, and is 
no different tnan the previous 1.4 release. It should be noted that 
the 1.4 DESPOOL program will not operate under version 2.0 , but an 
update version will be available from Digital Research in the near 
future. 



The "SECTRAN" (Sector Number Translate) entry shown in the jump 
vector at line 6 provides access to a BIOS-resident sector translation 
subroutine. This mechanism allows the user to specify the sector skew 
factor and translation for a particular disk system, and is described 
below. 

A macro library is shown in the listing,, called DISKDEF, 
included on line 2, and referenced in 12-15. Although it is not 
necessary to use the macro liorary, it greatly simplifies the disk 
definition process. you must have access to the MAC macro assembler, 
of course, to use the DISKDEF facility, while the macro library is 
included with all CP/M 2.0 distribution disks. (See the CP/M 2.0 
Alteration Guide for formulas which you can use to hand-code the 
taoles produced by the DISKDEF library) . 



A BIOS disk definition consists of 
macro statements: 



the following sequence of 



M ACL IB 

DISKS 

DISKDEF 

DISKDEF 



DISKDEF 

n 

0,.. . 

-L , . . • 



DISKDEF n-1 



ENDEF 



where the MACLIB statement loads the DISKDEF. LIB 
disk as your BIOS) into MAC's internal tables. 
follows, which specifies the number of drives to 
your system, where n is an integer in the range ; 
DISKDEF macro calls then follow which define the 



file (on the same 

The DISKS macro call 

be configured with 

. to 16. A series of 

characteristics of 



each logical disk, through n-1 (corresponding to logical drives A 
through P) . Note that the DISKS and DISKDEF macros generate in-line 
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fixed data tables, and thus must be placed in a non-executable portion 
of your BIOS, typically directly following the BIOS jump vector. 

The remaining portion of your SIOS is defined following the 

DISKDEF macros, with the ENDEF macro call immediately preceding the 

END statement. The ENDEF (End of Diskdef) macro generates the 

necessary uninitialized RAM areas which are located above your BIOS. 

The form of the DISKDEF macro call is 

DISKDEF dn f fsc, lsc, [skf] ,bls r dks f dir ,cks,of s, [0] 

where 

dn is the logical disk number, to n-1 

fsc is the first physical sector number (0 or 1) 

lsc is the last sector number 

skf is the optional sector skew factor 

bis is the data allocation block size 

dir is the number of directory entries 

cks is the number of "checked" directory entries 

ofs is the track offset to logical track 00 

[0] is an optional 1.4 compatibility flag 

The value "dn" is the drive number being defined with this DISKDEF 
macro invocation. The "fsc" parameter accounts for differing sector 
numbering systems, and is usually or 1. The "lsc" is the last 
numbered sector on a track. When present, the "skf" parameter defines 
the sector skew factor which is used to create a sector translation 
table according to the skew. If the number of sectors is less than 
256, a single-byte table is created, otherwise each translation table 
element occupies two bytes. No translation table is created if the 
skf parameter is omitted (or equal to 0). The "bis" parameter 
specifies the number of bytes allocated to each data block, and takes 
on the values 1024, 2048, 4096, 8192, or 16384. Generally, 
performance increases with larger data block sizes since there are 
fewer directory references and logically connected data records are 
physically close on the disk. Further, each directory entry addresses 
more data and the BIOS-resident ram space is reduced. The "dks" 
specifies the total disk size in "bis" units. That is, if the bis = 
2048 and dks = 1000, tnen the total disk capacity is 2,048,000 bytes. 
If dks is greater than 255, then the block size parameter bis must be 
greater than 1024. The value of "dir" is the total number of 
directory entries which may exceed 255, if desired. The "cks" 
parameter determines the number of directory items to check on each 
directory scan, and is used internally to detect changed disks during 
system operation where an intervening cold or warm start has not 
occurred (when this situation is detected, CP/M automatically marks 
the disk read/only so that data is not subsequently destroyed) . 
Normally the value of cks = dir when the media is easily changed, as 
is the case with a floppy disk subsystem. If the disk is permanently 
mounted, then the value of cks is typically 0, since the probability 
of cnanging disks without a restart is quite low. The "ofs" value 
determines the number of tracks to" skip when this particular drive is 
addressed, which can be used to reserve additional operating system 
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space or to simulate several logical drives on a single large capacity 
physical drive. Finally, the [0] parameter is included when file 
compatibility is required with versions of 1.4 which have been 
modified for higher density disks. This parameter ensures that only 
16K is allocated for each directory record, as was the case for 
previous versions. Normally, this parameter is not included. 

For convenience and economy of table space, the special form 

DISKDEF i,j 

gives disk i the same characteristics as a previously defined drive j. 
A standard four-drive single density system, which is compatible with 
version 1.4, is defined using the following macro invocations: 

DISKS 4 

DISKDEF 0,1,26,6,1024,243,64,64,2 

DISKDEF 1,0 

DISKDEF 2,0 

DISKDEF 3,0 

• • • * 

ENDEF 

with all disKs having the same parameter values of 26 sectors per 
track (numbered 1 through 26) , with 6 sectors skipped between each 
access, 1024 bytes per data block, 243 data blocks for a total of 243k 
byte disk capacity, 64 checked directory entries, and two operating 
system tracks. 

The definitions given in the program shown above (lines 12 
through 15) provide access to the largest disks addressable by CP/M 
2.0. All disks have identical parameters, except that drives and 2 
skip three sectors on every data access, while disks 1 and 3 access 
each sector in sequence as the disk revolves (there may, however, be a 
transparent hardware skew factor on these drives) . 

The DISKS macro generates n "disk header blocks," starting at 
address DPBASE which is a label generated by the macro. Each disk 
header block contains sixteen bytes, and correspond, in sequence, to 
each of the defined drives. In the four drive standard system, for 
example, the DISKS macro generates a table of the form: 

$ 

XLT0 ,0000H,0 000H,0000H,DIRBUF,DP30 ,CSV0 ,ALV0 
XLT0,0 00H,0 00H,0 00H,DIRBUF,DPB0 ,CSVl,ALVl 
XLT0,0 00H,0 00H,0 00H,DIRBUF,DPB0,CSV2,ALV2 
XLT0,0 00H,0 00H,0 00H,DIRBUF,DPB0,CSV3,ALV3 

where the DPE (disk parameter entry) labels are included for reference 
purposes to show the beginning table addresses for each drive 
through 3. The values contained within the disk parameter header are 
described in detail in the CP/M 2.0 Alteration Guide, but basically 
address the translation vector for the drive (all reference XLT0 , 
which is the translation vector for drive in the above example) , 
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DPBASE 


EQU 


DPE0: 


DW 


DPE1: 


DW 


DPE 2: 


DW 


DPE3: 


DW 



followed by three 16-bit "scratch" addresses, followed by the 
directory buffer address, disk parameter block address, check vector 
address, and allocation vector address. The check and allocation 
vector addresses are generated by the ENDEF macro in the ram area 
following the BIOS code and tables. 

The SELDSK function is extended somewhat in version 2.0. In 
particular, the selected disk number is passed to the BIOS in register 
C, as before, and the SELDSK subroutine performs the appropriate 
software or hardware actions to select the disk. Version 2.0, 
however, also requires the SELDSK subroutine to return the address of 
the selected disk parameter header (DPE0, DPE1 , DPE2, or DPE3, in the 
above example) in register HL. If SELDSK returns the value HL = 
0000H, then the BDOS assumes the disk does not exist, and prints a 
select error mesage at the terminal. Program lines 22 through 36 give 
a sample CP/M 2.0 SELDSK subroutine, showing only the disk parameter 
header address calculation. 

The subroutine SECTRAN is also included in version 2.0 which 
performs the actual logical to physical sector translation. In 
earlier versions of CP/M, the sector translation process was a part of 
the BDOS, and set to skip six sectors between each read. Due 
differing rotational speeds of various disks, the translation function 
has become a part of the BIOS in version 2.0. Thus, the BDOS sends 
sequential sector numbers to SECTRAN, starting at sector number 0. 
The SECTRAN subroutine uses the sequential sector number to produce a 
translated sector number which is returned to the BDOS. The BDOS 
subsequently sends the translated sector number to SELSEC before the 
actual read or write is performed. Note that many controllers have 
the capability to record the sector skew on the disk itself, and thus 
there is no translation necessary. In this case, the "skf" parameter 
is omitted in the macro call, and SECTRAN simply returns the same 
value which it receives. The table shown below, for example, is 
constructed when the standard skew factor skf = 6 is specified in the 
DISKDEF macro call: 

XLT0 : DB 1,7,13,19,25,5,11,17,23,3,9,15,21 
DB 2,8,14,20,26,6,12,18,24,4,10,16,22 

If SECTRAN is required to translate a sector, then the following 
process takes place. The sector to translate is received in register 
pair BC. Only the C register is significant if the sector value does 
not exceed 255 (B = 00 in this case) . Register pair DE addresses the 
sector translate table for this drive, determined by a previous call 
on SELDSK, corresponding to the first element of a disk parameter 
header (XLT0 in the case shown above). The SECTRAN subroutine then 
fetches the translated sector number by adding the input sector number 
to the base of the translate taole, to get the indexed translate table 
address (see lines 46, 47, and 48 in the above program). The value at 
this location is then returned in register L. Note that if the number 
of sectors exceeds 255, the translate table contains 16-bit elements 
whose value must be returned in HL. 

Following the ENDEF macro call, a number of uninitialized data 
areas are defined. These data areas need not be a part of the BIOS 
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which is loaded upon cold start, but must be available between the 
3I0S and the end of memory. The size of the uninitialized RAM area is 
determined by EQU statements generated by the ENDEF macro. For a 
standard four-drive system, the ENDEF macro"might oroduce 

4C72 = BEG DAT EQU $ 
(data areas) 
4DB0 = ENDDAT EQU $ 
013C = DATSIZ EQU $-3EGDAT 

which indicates that uninitialized RAM begins at location 4C72H, ends 
at 4DB0H-1, and occupies 013CH bytes. You must ensure that these 
addresses are free for use after the system is loaded. 

CP/M 2.0 is also easily adapated to disk subsystems whose sector 
size is a multiple of 128 bytes. Information is provided by the BDOS 
on sector write operations whicn eliminates the need for pre-read 
operations, thus allowing olocking and deblocking to take place at the 
BIOS level. 

See the "CP/M 2.0 Alteration Guide" for additional details 
concerning tailoring your CP/M system to your particular hardware. 
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CP/M Dynamic Debugging Tool (DDT) 
User 's Guide 



I. Introduction. 

The DDT program allows dynamic interactive testing and debugging of 
programs generated in the CP/M environment. The debugger is initiated by 
typing one of the following commands at the CP/M Console Command level 

DDT 

DDT filename. HEX 

DDT filename.COM 

where "filename" is the name of the program to be loaded and tested. In both 
cases, the DDT program is brought into main memory in the place of the Console 
Command Processor (refer to the CP/M Interface Guide for standard memory 
organization) , and thus resides directly below the Basic Disk Operating System 
portion of CP/M. The BDOS starting address, which is located in the address 
field of the JMP instruction at location 5H, is altered to reflect the reduced 
Transient Program Area size. 

The second and third forms of the DDT command shown above perform the same 
actions as the first, except there is a subsequent automatic load of the 
specified HEX or COM file. The action is identical to the sequence of 
commands 

DDT 

Ifilename.HEX or Ifilename.COM 

R 

where the I and R commands set up and read the specified program to test (see 
the explanation of the I and R commands below for exact details) . 

Upon initiation, DDT prints a sign-on message in the format 

nnK DDr-s VER m.m 

where nn is the memory size (which must match the CP/M system being used) , s 
is the hardware system which is assumed, corresponding to the codes 

D - Digital Research standard version 

M - MDS version 

I - IMSAI standard version 

- Qrnron systems 

S - Digital Systems standard version 

and m.m is the revision number. 



Following the sign on message, DOT prompts the operator with the character 
"-" and waits for input commands from the console. The operator can type any 
of several single character commands, terminated by a carriage return to 
execute the command. Each line of input can be line-edited using the standard 
CP/M controls 

rubout remove the last character typed 

ctl-U remove the entire line, ready for re-typing 

ctl-C system reboot 

Any command can be up to 32 characters in length (an automatic carriage return 
is inserted as the 33rd character) , where the first character determines the 
command type 

A enter assembly language mnemonics with operands 

D display memory in hexadecimal and ASCII 

F fill memory with constant data 

G begin execution with optional breakpoints 

I set up a standard input file control block 

L list memory using assembler mnemonics 

M move a memory segment from source to destination 

R read program for subsequent testing 

S substitute memory values 

T trace program execution 

U untraced program monitoring 

X examine and optionally alter the CPU state 

The canmand character, in some cases, is followed by zero, one, two, or three 
hexadecimal values which are separated by commas or single blank characters. 
All DOT numeric output is in hexadecimal form. In all cases, the commands are 
not executed until the carriage return is typed at the end of the command. 

At any point in the debug run, the operator can stop execution of DDT 
using either a ctl-C or G0 (jmp to location 0000H) , and save the current 
memory image using a SAVE command of the form 

SAVE n filename.COM 

where n is the number of pages (256 byte blocks) to be saved on disk. The 
number of blocks can be determined by taking the high order byte of the top 

1 naH arirlrocc ^nr\ prinuorfi nn f-hic nnmKor t-rv rlocimal Pnr ovamnla if- f-'no 

highest address in the Transient Program Area is 1234H then the number of 
pages is 12H, or 18 in decimal. Thus the operator could type a ctl-C during 
the debug run, returning to the Console Processor level, followed by 

SAVE 18 X.COM 

The memory image is saved as X.COM on the diskette, and can be directly 
executed by simply typing the name X. If further testing is required, the 
memory image can be recalled by typing 



DDT X.COM 

which reloads previously saved program from loaction 100H through page 18 
(12FFH) . The machine state is not a part of the COM file, and thus the 
program must be restarted from the beginning in order to properly test it. 

II. DOT COMMANDS. 

The individual commands are given below in some detail. In each case, the 
operator must wait for the prompt character (-) before entering the command. 
If control is passed to a program under test, and the program has not reached 
a breakpoint, control can be returned to DDT by executing a RST 7 from the 
front panel (note that the rubout key should be used instead if the program is 
executing a T or U command) . In the explanation of each command, the command 
letter is shown in some cases with numbers separated by commas, where the 
numbers are represented by lower case letters. These numbers are always 
assumed to be in a hexadecimal radix, and from one to four digits in length 
(longer numbers will be automatically truncated on the right) . 

Many of the commands operate upon a "CPU state" which corresponds to the 
program under test. The CPU state holds the registers of the program being 
debugged, and initially contains zeroes for all registers and flags except for 
the program counter (P) and stack pointer (S) , which default to 100H. The 
program counter is subsequently set to the starting address given in the last 
record of a HEX file if a file of this form is loaded (see the I and R 
commands) . 

1. The A (Assemble) Command. DDT allows inline assembly language to be 
inserted into the current memory image using the A command which takes the 
form 

As 

where s is the hexadecimal starting address for the inline assembly. DDT 
prompts the console with the address of the next instruction to fill, and 
reads the console, looking for assembly language mnemonics (see the Intel 8080 
Assembly Language Reference Card for a list of mnemonics) , followed by 
register references and operands in absolute hexadecimal form. Each sucessive 
load address is printed before reading the console. The A command terminates 
when the first empty line is input from the console. 

Upon completion of assembly language input, the operator can review the 
memory segment using the DDT disassembler (see the L command) . 

Note that the assembler/disassembler portion of DDT can be overlayed by 
the transient program being tested, in which case the DDT program responds 
with an error condition when the A and L commands are used (refer to Section 
IV). 



2. The D (Display) Command. The D command allows the operator to view 
the contents of memory in hexadecimal and ASCII formats. The forms are 

,.....• ......... ;.... D , 

Ds 
Ds,f 

In the first case, memory is displayed from the current display address 
(initially 100H) , and continues for 16 display lines. Each display line takes 
the, form shown below 

.aaaa bb bb bb bb bb bb bb bb bb bb bb bb bb bb bb bb cccccccccccccccc 

where aaaa is the display address in hexadecimal, and bb represents data 
present in iremory starting at aaaa. The ASCII characters starting at aaaa are 
given to the right (represented by the sequence of c's) , where non-graphic 
characters _ are printed as a period (.) symbol. Note that both upper and lower 
case , alphabetics are displayed, and thus will appear as upper case symbols on 
a console device that supports only upper case. Each display line gives the 
values of 16 bytes of data, except that the first line displayed is truncated 
so that the next line begins at an address which is a multiple of 16. 

the second form of the p command shown above is similar to the first, 
except jthat the display address is first set to address s. The third form 
causes tne display to continue from address s through address f. In all 
cases, the display address is set to the first address not displayed in this 
command, so that a continuing display can be accomplished by issuing 
successive D commands with no explicit addresses. 

Excessively long displays can be aborted by pushing the rubout key. 



. 3. The F .(Fill) Command . The F command takes the form 

Fs,f ,c ; 

where' s is the starting address, f is the final address, and c is a 
hexadecimal byte constant. The effect is as follows: DDT stores the constant 
c at address s, increments the Value of s and tests against f . If s exceeds f 
then the operation terminates, otherwise the operation is repeated. Thus, the 
fill command can be used to set a memor^ block to a specific constant value* 



4. The G (Go) Command. Program execution is started using the G comand, 
with up to two optional breakpoint addresses. The G command takes one ot the 
forms 

'"' G '■'' ■ 

Gs 
Gs,b 



Gs,b,c 

G,b 

G,b,c 

The first form starts execution of the program under test at the current value 
of the program counter in the current machine state, with no breakpoints set 
(the only way to regain control in DDT is through a RST 7 execution) . The 
current program counter can be viewed by typing an X or XP command. The 
second form is similar to the first except that the program counter in the 
current machine state is set to address s before execution begins. The third 
form is the same as the second, except that program execution stops when 
address b is encountered (b must be in the area of the program under test) . 
The instruction at location b is not executed when the breakpoint is 
encountered. The fourth form is identical to the third, except that two 
breakpoints are specified, one at b and the other at c. Encountering either 
breakpoint causes execution to stop, and both breakpoints are subsequently 
cleared. The last two forms take the program counter from the current machine 
state, and set one and two breakpoints, respectively. 

Execution continues from the starting address in real-time to the next 
breakpoint. That is, there is no intervention between the starting address 
and the break address by DDT. Thus, if the program under test does not reach 
a breakpoint, control cannot return to DDT without executing a RST 7 
instruction. Upon encountering a breakpoint, DDT stops execution and types 

*d 

where d is the stop address. The machine state can be examined at this point 
using the X (Examine) command. The operator must specify breakpoints which 
differ from the program counter address at the beginning of the G command. 
Thus, if the current program counter is 1234H, then the commands 



and 



G,1234 
G400,400 



both produce an immediate breakpoint, without executing any instructions 
whatsoever. 



5. The I (Input) Command. The I command allows the operator to insert a 
file name into the default file control block at 5CH (the file control block 
created by CP/M for transient programs is placed at this location; see the 
CP/M Interface Guide) . The default FCB can be used by the program under test 
as if it had been passed by the CP/M Console Processor. Note that this file 
name is also used by DDT for reading additional HEX and COM files. The form 
of the I command is 

Ifilename 
or 



If ilename . f iletype 

If the second form is used, and the f iletype is either HEX or COM, then 
subsequent R commands can be used to read the pure binary or hex format 
machine code (see the R command for further details) . 

6. The L (List) Command. The L command is used to list assembly language 
mnemonics in a particular program region. The forms are 

L 

Ls 

Ls,f 

The first command lists twelve lines of disassembled machine code from the 
current list address. The second form sets the list address to s, and then 
lists twelve lines of code. The last form lists disassembled code from s 
through address f. In all three cases, the list address is set to the next 
unlisted location in preparation for a subsequent L command. Upon 
encountering an execution breakpoint, the list address is set to the current 
value of the program counter (see the G and T commands) . Again, long typeouts 
can be aborted using the rubout key during the list process. 

7. The M (Move) Command. The M command allows block movement of program 
or data areas from one location to another in memory. The form is 

Ms,f,d 

where s is the start address of the move, f is the final address of the move, 

and d is the destination address. Data is first moved from s to d, and both 

addresses are incremented. If s exceeds f then the move operation stops, 
otherwise the move operation is repeated. 

8. The R (Read) Command. The R command is used in conjunction with the I 
command to read COM and HEX files from the diskette into the transient program 
area in preparation for the debug run. The forms are 

R 
Rb 

where b is an optional bias address which is added to each program or data 
address as it is loaded. The load operation must not overwrite any of the 
system parameters from 000H through 0FFH (i.e., the first page of memory). If 
b is omitted, then b=0000 is assumed. The R command requires a previous I 
command, specifying the name of a HEX or COM file. The load address for each 
record is obtained from each individual HEX record, while an assumed load 
address of 100H is taken for COM files. Note that any number of R commands 
can be issued following the I command to re-read the program under test, 



assuming the tested program does not destroy the default area at 5CH. 
Further, any file specified with the filetype "COM" is assumed to contain 
machine code in pure binary form (created with the LOAD or SAVE command) , and 
all others are assumed to contain machine code in Intel hex format (produced, 
for example, with the ASM command). 

Recall that the command 

DDT filename. filetype 

which initiates the DDT program is equivalent to the commands 

DDT 

-If ilename. filetype 

-R 

Whenever the R command is issued, DDT responds with either the error indicator 
"?" (file cannot be opened, or a checksum error occurred in a HEX file) , or 
with a load message taking the form 

NEXT PC 
nnnn pppp 

where nnnn is the next address following the loaded program, and pppp is the 
assumed program counter (100H for COM files, or taken from the last record if 
a HEX file is specified) . 

9. The S (Set) Command. The S command allows memory locations to be 
examined and optionally altered. The form of the command is 

Ss 

where s is the hexadecimal starting address for examination and alteration of 
memory. DDT responds with a numeric prompt, giving the memory location, along 
with the data currently held in the memory location. If the operator types a 
carriage return, then the data is not altered. If a byte value is typed, then 
the value is stored at the prompted address. In either case, DDT continues to 
prompt with successive addresses and values until either a period (.) is typed 
by the operator, or an invalid input value is detected. 

10. The T (Trace) Command. The T command allows selective tracing of 
program execution for 1 to 65535 program steps. The forms are 

T 
Tn 

In the first case, the CPU state is displayed, and the next program step is 
executed. The program terminates immediately, with the termination address 



displayed as 

*hhhh 

where hhhh is the next address to execute. The display address (used in the D 
command) is set to the value of H and L r and the list address (used in the L 
command) is set to hhhh. The CPU state at program termination can then be 
examined using the X command. 

The second form of the T command is similar to the first, except that 
execution is traced for n steps (n is a hexadecimal value) before a program 
breakpoint is occurs. A breakpoint can be forced in the trace mode by typing 
a rubout character. The CPU state is displayed before each program step is 
taken in trace mode. The format of the display is the same as described in 
the X command. 

Note that program tracing is discontinued at the interface to CP/M r and 
resumes after return from CP/M to the program under test. Thus, CP/M 
functions which access I/O devices, such as the diskette drive, run in 
real-time, avoiding I/O timing problems. Programs running in trace mode 
execute approximately 500 times slower than real time since DOT gets control 
after each user instruction is executed. Interrupt processing routines can be 
traced, but it must be noted that commands which use the breakpoint facility 
(G, T, and U) accomplish the break using a RST 7 instruction, which means that 
the tested program cannot use this interrupt location. Further, the trace 
mode always runs the tested program with interrupts enabled, which may cause 
problems if asynchronous interrupts are received during tracing. 

Note also that the operator should use the rubout key to get control back 
to DDT during trace, rather than executing a RST 7, in order to ensure that 
the trace for the current instruction is completed before interruption. 

11. The U (Untrace) Command. The U command is identical to the T command 
except that intermediate program steps are not displayed. The untrace mode 
allows from 1 to 65535 (0FFFFH) steps to be executed in monitored mode, and is 
used principally to retain control of an executing program while it reaches 
steady state conditions. All conditions of the T command apply to the U 
command. 



12. The X (Examine) Command. The X command allows selective display and 
alteration of the current CPU state for the program under test. The forms are 

X 
Xr 

where r is one of the 8080 CPU registers 

C Carry Flag (0/1) 
Z Zero Flag (0/1) 



M 


Minus Flag 


(0/1) 


E 


Even Parity Flag 


(0/1) 


I 


Interdigit Carry 


(0/1) 


A 


Accumulator 


(0-FF) 


B 


BC register pair 


(0-FFFF) 


D 


DE register pair 


(0-FFFF) 


H 


HL register pair 


(0-FFFF) 


S 


Stack Pointer 


(0-FFFF) 


P 


Program Counter 


(0-FFFF) 



In the first case, the CPU register state is displayed in the format 

CfZfMfEflf A=bb B=dddd D=dddd H=dddd S=dddd P=dddd inst 

where f is a or 1 flag value, bb is a byte value, and dddd is a double byte 
quantity corresponding to the register pair. The "inst" field contains the 
disassembled instruction which occurs at the location addressed by the CPU 
state's program counter. 

The second form allows display and optional alteration of register values, 
where r is one of the registers given above (C, Z, M, E, I, A, B, D, H, S, or 
P) . In each case, the flag or register value is first displayed at the 
console. The DDT program then accepts input from the console. If a carriage 
return is typed, then the flag or register value is not altered. If a value 
in the proper range is typed, then the flag or register value is altered. 
Note that BC, DE, and HL are displayed as register pairs. Thus, the operator 
types the entire register pair when B, C, or the BC pair is altered. 

III. IMPLEMENTATION NOTES. 

The organization of DDT allows certain non-essential portions to be 
overlayed in order to gain a larger transient program area for debugging large 
programs. The DDT program consists of two parts: the DDT nucleus and the 
assembler/disassembler module. The DDT nucleus is loaded over the Console 
Command Processor, and, although loaded with the DDT nucleus, the 
assembler/disassembler is overlayable unless used to assemble or disassemble. 

In particular, the BDOS address at location 6H (address field of the JMP 
instruction at location 5H) is modified by DDT to address the base location of 
the DDT nucleus which, in turn, contains a JMP instruction to the BDOS. Thus, 
programs which use this address field to size memory see the logical end of 
memory at the base of the DDT nucleus rather than the base of the BDOS. 

The assembler /disassembler module resides directly below the DDT nucleus 
in the transient program area. If the A, L, T, or X commands are used during 
the debugging process then the DDT program again alters the address field at 
6H to include this module, thus further reducing the logical end of memory. 
If a program loads beyond the beginning of the assembler/disassembler module, 
the A and L commands are lost (their use produces a "?" in response) , and the 



trace and display (T and X) commands list the "inst" field of the display in 
hexadecimal, rather than as a decoded instruction. 

IV. AN EXAMPLE. 

The following example shows an edit, assemble, and debug for a simple 
program which reads a set of data values and determines the largest value in 
the set. The largest value is taken from the vector, and stored into "LARGE" 
at the termination of the program 



ED SCAN. ASM 



*1, 



u 



/ 



frtf*** 



ORG t-I 108H 

MVJ 

MVI 
LQ0P --P..Q-Q.L 
LOOP:* MOV 



LfL'rSTAF 



•\ 



A 



ij»* 



W 



NFOUND-. 



VECT: 

LEH 
LARGE: 

**B8P* 



LOOP 



NFOUND 



NEW 



B.LEN 
C, 8 
LXI 

NFOUND 
LARGEST VALUED 



OF TRANSIENT AREA 
LENGTH OF VECTOR TO SCAN , ' 



;LARGER_RST VALUE §0 FAR 
H, VECT ;B ASE OF VECTOR, 1 
GET VALUE . 



LARGER VALUE IN C 



JUHP IF LARGER VAL 



NOT FOUND 



STORE IT TO C 



MOV 
INK 
OCR 
vlNZ 



H * 

JL 

LOOP 



TO NEXT ELEMENT. 



MORE TO SCAN? 



FOR AHOTHER j 



END OF SCAN, STORE C, 



MOV 
STA 
JMP 



A , C 
LARGE 
JL 



GET LARGEST VALUE 



/REBOOT . 



TEST DATA 



&t£t Source, 
ctuuacfafs jgyed 

"j" Yew&uk Coax** 



2, 6, 4, 3. 5, 6, 1 , 5- 



f,-VECT 
1 



LENGTH ;, 
LARGEST 



VALUE ON EXIT 



108H 

B, LEN 
CO 

H, VECT 
A, M 
C 
NFOUND 

LARGEST VALUE> 

C, A 



START OF TRANSIENT AREA 
LENGTH OF VECTOR TO SCAN 
LARGEST VALUE SO FAR 
BASE OF VECTOR 
GET VALUE 

LARGER VALUE IN C? 
JUMP IF LARGER VALUE NOT 
IT TO C 



FOUND 



STORE 



H 
B 
LOOP 



TO NEXT 
MORE TO 



ELEMENT 
SCAN? 



FOR ANOTHER 



10 



END OF SCAN, STORE C 

MOV A,C ;GET LARGEST VALUE 

STA LARGE 

JMP 8 ;REBOOT 

.; TEST DATA 

VECT: DB 2, 0, 4, 3, 5, 6, 1, 5 

LEN EQU *-VECT ; LENGTH 

LARGE: DS 1 ^LARGEST VALUE ON EXIT 
END 



ASH SCAN 



SW+ k&Mef 



CP/» ASSEMBLER - VER 1 . 



0122 

682H USE FACTOR . . » . . . • .. 

END OF ASSEMBLY A^S^Vi\V|U| (Wfefc ' iM tft iUfaWl UStlW 

TYRE SCAN.PRN 



816 Wackwe Codt 

9100 8608 ; 

8162 8E60^ 

8164 211981 

0107 7E 

0188 91 

0109 D20D01 

010C 4F 
818B 23 
018E 85 
818F C20781 



C SoMce ftcgra* 



LOOP: 



N FOUND 



ORG 108H ; START OF TRANSIENT AREA 

MVI B, LEN i LENGTH OF VECTOR TO SCAN 

MVI C, 8 ; LARGEST VALUE SO FAR 

LKI H>VECI ; BASE OF VECTOR 

MOV A, M ; GET VALUE 

SUB C ; LARGER VALUE IN C? 

JNC NFOUND ;JUMP IF LARGER VALUE NOT FOUND 

NEW LARGEST VALUE.. STORE IT TO C 

MOV C, A 

IHX H ;TO NEXT ELEMENT 

DCR B ;MORE TO SCAN? 

JNZ LOOP ;FOR ANOTHER 



0112 79 

0113 322181 
0116 C38888 

Cck/iaL llsWy > 
^YUrtded v — ^; 
0119 8280840305VECT: 
0868 = <->. LEN 

8i2i Mueck ) large: 

0122 ^^ 



END OF SCAN, STORE C 

MOV A, C ;GET LARGEST VALUE 

STA LARGE 

JMP 8 .• REBOOT 



TEST 


DATA 








DB 


2, 


8, 4, 3. 


5 > 6 > 1.5 




EQU 


$- 


-VECT 


; LENGTH 




DS 


i 




; LARGEST VALUE 


ON EXIT 


END 











11 



DDT SCA N. HEX 
j 

iSK DDT VER 1. 
NEXT PC 



6-Wt Debugs us^ hex -fawucf vwitktyie 0>dt 



01 

">L 

ce 

p= 
-x 
ce 



2L 0880 
^ 



lost- lao( odAr«s + 1 



28M0E8I8 

p 



A=08 B=0000 D=8868 H=0080 S=8188 ?■ 



* -k> e&adt at 

00 8 OUT 7F 



0000 



108 






t*>0 



Z6M8E8I0 A=00 B=0880 D=8880 H=8880 

100 . 



S=8188 P=0 100 MVI 



180 


MVI 


B, 88 


8192 


MVI 


C, 88 


81 84 


LXI 


H , 1 1 3 


018? 


MOV 


A, M 


8188 


SUB 


C 


8189 


JNC 


010D 


8 18C 


MOV 


C, A 


818D 


I NX 


H 


?18E 


DCR 


B 


818F 


JNZ 


0107 


81 12 


MOV 


A, C 


-L 






~7 






8 i 13 


ST A 


1 2 i 


81 16 


JMP 


0000 


81 19 


ST AX 


B 


81 1 A 


NOP 




8 1 IB 


INR 


B 


81 10 


I NX 


B 


8 1 ID 


DCR 


B 


81 IE 


MVI 


B , 8 1 


8128 


DCR 


B 


0121 


LXI 


D, 2 20 8 


8124 


LXI 


H, 20 


- A 1 1 6 


. 0*k 


V MllK6 



^ 



B, 8 3*^) 



r DtsaesmlU RacW 
Cok a\ IDoU . 
(%€t Sana Listing 



8 1 

01 
-L 



J 



A 



modnwtCcAt 
* e\Ack>ai bcocfiofi lit 

J UJiUv a CJUP \o KWO) 
o&evddb mock 4o eUwe 4ta 3Uf -to 0000 iMo a PS* 7, . 
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CP/M Assembler User's Guide 

1. INTRODUCTION. 

The CP/M assembler reads assembly language source files from the diskette, 
and produces 8080 machine language in Intel hex format. The CP/M assembler is 
initiated by typing 



or 



ASM filename 

ASM filename. parms 



In both cases, the assembler assumes there is a file on the diskette with the 
name 

filename .ASM 

which contains an 8080 assembly language source file. The first and second 

forms shown above differ only in that the second form allows parameters to be 

passed to the assembler to control source file access and hex and print file 
destinations. 

In either case, the CP/M assembler loads, and prints the message 

CP/M ASSEMBLER VER n.n 

where n.n is the current version number. In the case of the first command, 
the assembler reads the source file with assumed file type "ASM" and creates 
two output files 

filename. HEX 
and 

filename.PRN 

the "HEX" file contains the machine code corresponding to the original program 
in Intel hex format, and the "PRN" file contains an annotated listing showing 
generated machine code, error flags, and source lines. If errors occur during 
translation, they will be listed in the PRN file as well as at the console 

The second command form can be used to redirect input and output files 
from their defaults. In this case, the "parms" portion of the command is a 
three letter group which specifies the origin of the source file, the 
destination of the hex file, and the destination of the print file. The form 
is 

filename.plp2p3 
where pi, p2, and p3 are single letters 

pi: A,B, ..., Y designates the disk name which contains 



the source file 
p2: A,B, . .., Y designates the disk name which will re- 
ceive the hex file 
Z skips the generation of the hex file 

p3: A,B, . .., Y designates the disk name which will re- 
ceive the print file 
X places the listing at the console 

Z skips generation of the print file 

Thus, the command 

ASM X.AAA 

indicates that the source file (X.ASM) is to be taken from disk A, and that 
the hex (X.HEX) and print (X.PRN) files are to be created also on disk A. 
This form of the command is implied if the assembler is run from disk A. That 
is, given that the operator is currently addressing disk A, the above command 
is equivalent to 

ASM X 

The command 

ASM X.ABX 

indicates that the source file is to be taken from disk A, the hex file is 
placed on disk B, and the listing file is to be sent to the console. The 
command 

ASM X.BZZ 

takes the source file from disk B, and skips the generation of the hex and 
print files (this command is useful for fast execution of the assembler to 
check program syntax) . 

The source program format is compatible with both the Intel 8080 assembler 
(macros are not currently implemented in the CP/M assembler, however) , as well 
as the Processor Technology Software Package #1 assembler. That is, the CP/M 
assembler accepts source programs written in either format. There are certain 
extensions in the CP/M assembler which make it somewhat easier to use. These 
extensions are described below. 

2. PROGRAM FORMAT. 

An assembly language program acceptable as input to the assembler consists 
of a sequence of statements of the form 

line# label operation operand ; comment 

where any or all of the fields may be present in a particular instance. Each 



^embly language statement is terminated with a carriage return and line feed 
(the line feed is inserted automatically by the ED program) , or with the 
character " !" which is a treated as an end-of-line by the assembler (thus, 
multiple assembly language statements can be written on the same physical line 
if separated by exclaim symbols) . 

The line# is an optional decimal integer value representing the source 
program line number, which is allowed on any source line to maintain 
compatibility with the Processor Technology format. In general, these line 
numbers will be inserted if a line-oriented editor is used to construct the 
original program, and thus ASM ignores this field if present. 

The label field takes the form 

identifier 
or 

identifier: 

and is optional, except where noted in particular statement types. The 
identifier is a sequence of alphanumeric characters (alphabetics and numbers) , 
where the first character is alphabetic. Identifiers can be freely used by 
the programmer to label elements such as program steps and assembler 
directives, but cannot exceed 16 characters in length. All characters are 
significant in an identifier, except for the embedded dollar symbol ($) which 
can be used to improve readability of the name. Further, all lower case 
alphabetics become are treated as if they were upper case. Note that the ":" 
following the identifier in a label is optional (to maintain compatibility 
between Intel and Processor Technology) . Thus, the following are all valid 
instances of labels 



X 


xy 


long$name 


x: 


yxl: 


longer $named $data : 


X1Y2 


Xlx2 


x234$5678$9012$3456: 



The operation field contains either an assembler directive, or pseudo 
operation, or an 8080 machine operation code. The pseudo operations and 
machine operation codes are described below. 

The operand field of the statement, in general, contains an expression 
formed out of constants and labels, along with arithmetic and logical 
operations on these elements. Again, the complete details of properly formed 
expressions are given below. 

The comment field contains arbitrary characters following the ";" symbol 
until the next real or logical end-of-line. These characters are read, 
listed, and otherwise ignored by the assembler. In order to maintain 
compatability with the Processor Technology assembler, the CP/M assembler also 
treat statements which begin with a "*" in column one as comment statements, 
which are listed and ignored in the assembly process. Note that the Processor 



Technology assembler has the side effect in its operation of ignoring the 
characters after the operand field has been scanned. This causes an ambiguous 
situation when attempting to be compatible with Intel's language, since 
arbitrary expressions are allowed in this case. Hence, programs which use 
this side effect to introduce comments, must be edited to place a ";" before 
these fields in order to assemble correctly. 

The assembly language program is formulated as a sequence of statements of 
the above form, terminated optionally by an END statement. All statements 
following the END are ignored by the assembler. 

3. FORMING THE OPERAND. 

In order to completely describe the operation codes and pseudo operations, 
it is necessary to first present the form of the operand field, since it is 
used in nearly all statements. Expressions in the operand field consist of 
simple operands (labels, constants, and reserved words) , combined in properly 
formed subexpressions by arithmetic and logical operators. The expression 
computation is carried out by the assembler as the assembly proceeds. Each 
expression must produce a 16-bit value during the assembly. Further, the 
number of significant digits in the result must not exceed the intended use. 
That is, if an expression is to be used in a byte move immediate instruction, 
then the most significant 8 bits of the expression must be zero. The 
restrictions on the expression significance is qiven with the individual 
instructions. 

3.1. Labels. 

As discussed above, a label is an identifier which occurs on a particular 
statement. In general, the label is given a value determined by the type of 
statement which it precedes. If the label occurs on a statement which 
generates machine code or reserves memory space (e.g, a MOV instruction, or a 
DS pseudo operation) , then the label is given the value of the program address 
which it labels. If the label precedes an EQU or SET', then the label is given 
the value which results from evaluating the operand field. Except for the SET 
statement, an identifier can label only one statement. 

When a label appears in the operand field, its value is substituted by the 
assembler. This value can then be combined with other operands and operators 
to form the operand field for a particular instruction. 

3.2. Numeric Constants. 

A numeric constant is a 16-bit value in one of several bases. The base, 
called the radix of the constant, is denoted by a trailing radix indicator. 
The radix indicators are 

B binary constant (base 2) 
octal constant (base 8) 



Q octal constant (base 8) 

D decimal constant (base 10) 

H hexadecimal constant (base 16) 

is an alternate radix indicator for octal numbers since the letter is 
easily confused with the digit 0. Any numeric constant which does not 
terminate with a radix indicator is assumed to be a decimal constant. 

A constant is thus composed as a sequence of digits, followed by an 
optional radix indicator, where the digits are in the appropriate range for 
the radix. That is binary constants must be composed of and 1 digits, octal 
constants can contain digits in the range - 7, while decimal constants 
contain decimal digits. Hexadecimal constants contain decimal digits as well 
as hexadecimal digits A (10D) , B (11D) , C (12D) , D (13D) , E (14D) , and F 
(15D) . Note that the leading digit of a hexadecimal constant must be a 
decimal digit in order to avoid confusing a hexadecimal constant with an 
identifier (a leading will always suffice) . A constant composed in this 
manner must evaluate to a binary number which can be contained within a 16-bit 
counter, otherwise it is truncated on the right by the assembler. Similar to 
identifiers, imbedded "$" are allowed within constants to improve their 
readability. Finally, the radix indicator is translated to upper case if a 
lower case letter is encountered. The following are all valid instances of 
numeric constants 



1234 


1234D 


1100B 


1111$0000$1111$0000B 


1234H 


0FFEH 


33770 


33$77$22Q 


3377o 


0fe3h 


1234d 


0ffffh 



3.3. Reserved Words. 

There are several reserved character sequences which have predefined 
meanings in the operand field of a statement. The names of 8080 registers are 
given below, which, when encountered, produce the value shown to the right 



B 





C 


1 


D 


2 


E 


3 


H 


4 


L 


5 


M 


6 


SP 


6 


PStt 


6 



(again, lower case names have the same values as their upper case 
equivalents) . Machine instructions can also be used in the operand field, and 
evaluate to their internal codes. In the case of instructions which require 
operands, where the specific operand becomes a part of the binary bit pattern 



opi-fre instruction (e.g, 1VDV A,B) , the value of the instruction (in this case 
MOV) is the bit pattern of the instruction with zeroes in the optional fields 
(e.g, MOV produces 40H) . 

When the symbol "$" occurs in the operand field (not imbedded within 
identifiers and numeric constants) its value becomes the address of the next 
instruction to generate, not including the instruction contained wi thing the 
current logical line. 

3.4. String Constants. 

String constants represent sequences of ASCII characters, and are 
represented by enclosing the characters within apostrophe symbols ('). All 
strings must be fully contained within the current physical line (thus 
allowing "!" symbols within strings), and must not exceed 64 characters in 
length. The apostrophe character itself can be included within a string by 
representing it as a double apostrophe (the two keystrokes ") , which becomes 
a single apostrophe when read by the assembler. In most cases, the string 
length is restricted to either one or two characters (the DB pseudo operation 
is an exception) , in which case the string becomes an 8 or 16 bit value, 
respectively. Two character strings become a 16-bit constant, with the second 
character as the low order byte, and the first character as the high order 
byte. 

The value of a character is its corresponding ASCII code. There is no 
case translation within strings, and thus both upper and lower case characters 
can be represented. Note however, that only graphic (printing) ASCII 
characters are allowed within strings. Valid strings are 

'A' 'AB' 'ab' 'c' 
a "' 

'Walla Walla Wash. ' 

'She said "Hello" to me.' 

'I said "Hello" to her.' 

3.5. Arithmetic and Logical Operators. 

The operands described above can be combined in normal algebraic notation 
using any combination of properly formed operands, operators, and 
parenthesized expressions. The operators recognized in the operand field are 

a + b unsigned arithmetic sum of a and b 

a - b unsigned arithmetic difference between a and b 

+ b unary plus (produces b) 

- b unary minus (identical to - b) 

a * b unsigned magnitude multiplication of a and b 

a / b unsiqned magnitude division of a by b 

a MOD b remainder after a / b 

NOT b logical inverse of b (all 0's become l's, l's 

become 0's), where b is considered a 16-bit value 



a AND b bit-by-bit logical and of a and b 

a OR b bit-by-bit logical or of a and b 

a XOR b bit-by-bit logicl exclusive or of a and b 

a SHL b the value which results from shifting a to the 

left by an amount b, with zero fill 
a SHR b the value which results from shifting a to the 

right by an amount b, with zero fill 

In each case, a and b represent simple operands (labels, numeric 
constants, reserved words, and one or two character strings) , or fully 
enclosed parenthesized subexpressions such as 

liZH-20 10h+37Q LI /3 (L2+4) SHR 3 
('a' and 5fh) + '0' fB'+B) OR (PSW+M) 
(l+(2+c)) shr (A-(B+1)) 

Note that all computations are performed at assembly time as 16-bit unsigned 
operations. Thus, -1 is computed as 0-1 which results in the value 0ffffh 
(i.e., all l's). The resulting expression must fit the operation code in 
which it is used. If, for example, the expression is used in a ADI (add 
immediate) instruction, then the high order eight bits of the expression must 
be zero. As a result, the operation "ADI -1" produces an error message (-1 
becomes 0ffffh which cannot be represented as an 8 bit value) , while "ADI (-1) 
AND 0FFH" is accepted by the assembler since the "AND" operation zeroes the 
high order bits of the expression. 

3.6. Precedence of Operators. 

As a convenience to the programmer, ASM assumes that operators have a 
relative precedence of application which allows the programmer to write 
expressions without nested levels of parentheses. The resulting expression 
has assumed parentheses which are defined by the relative precedence. The 
order of application of operators in unparenthesize expressions is listed 
below. Operators listed first have highest precedence (they are applied first 
in an unparenthesized expression) , while operators listed last have lowest 
precedence. Operators listed on the same line have equal precedence, and are 
applied from left to right as they are encountered in an expression 

* / MOD SHL SHR 

- + 

NOT 

AND 

OR XOR 

Thus, the expressions shown to the left below are interpreted by the assembler 
as the fully parenthesize expressions shown to the right below 

a * b + c (a * b) + c 

a + b * c a + (b * c) 

a MOD b * c SHL d ( (a MOD b) * c) SHL d 



a OR b AND NOT c + d SHL e a OR (b AND (NOT (c + (d SHL e) ) ) ) 

Balanced parenthesized subexpressions can always be used to override the 
assumed parentheses, and thus the last expression above could be rewritten to 
force application of operators in a different order as 

(a OR b) AND (NOT c) + d SHL e 

resulting in the assumed parentheses 

(a OR b) AND ( (NOT c) + (d SHL e) ) 

Note that an unparenthesized expression is well-formed only if the expression 
which results from inserting the assumed parentheses is well-formed. 

4. ASSEMBLER DIRECTIVES. 

Assembler directives are used to set labels to specific values during the 
assmbly, perform conditional assembly, define storage areas, and specify 
starting addresses in the program. Each assembler directive is denoted by a 
"pseudo operation" which appears in the operation field of the line. The 
acceptable pseudo operations are 

ORG set the program or data origin 

END end program, optional start address 

EQU numeric "equate" 

SET numeric "set" 

IF begin conditional assembly 

ENDIF end of conditional assembly 

DB define data bytes 

DW define data words 

DS define data storage area 

The individual pseudo operations are detailed below 

4.1. The ORG directive. 

The ORG statement takes the form 

label ORG expression 

where "label" is an optional program label, and expression is a 16-bit 
expression, consisting of operands which are defined previous to the ORG 
statement. The assembler begins machine code generation at the location 
specified in the expression. There can be any number of ORG statements within 
a particular program, and there are no checks to ensure that the programmer is 
not defining overlapping memory areas. Note that most programs written for 
the CP/M system begin with an ORG statement of the form 

ORG 100H 



which causes machine code generation to begin at the base of the CP/M 
transient program area. If a label is specified in the ORG statement, then 
the label is given the value of the expression (this label can then be used in 
the operand field of other statements to represent this expression) . 

4.2. The END directive. 

The END statement is optional in an assembly language program, but if it 
is present it must be the last statement (all subsequent statements are 
ignored in the assembly) . The two forms of the END directive are 



label 
label 



END 
END 



expression 



where the label is again optional. If the first form is used, the assembly 
process stops, and the default starting address of the program is taken as 
0000. Otherwise, the expression is evaluated, and becomes the program 
starting address (this starting address is included in the last record of the 
Intel formatted machine code "hex" file which results from the assembly) . 
Thus, most CP/M assembly language programs end with the statement 

END 100H 

resulting in the default starting address of 100H (beginning of the transient 
program area) . 

4.3. The EQU directive. 

The EQU (equate) statement is used to set up synonyms for particular 
numeric values, the form is 

label EQU expression 

where the label must be present, and must not label any other statement. The 
assembler evaluates the expression, and assigns this value to the identifier 
given in the label field. The identifier is usually a name which describes 
the value in a more human-oriented manner. Further, this name is used 
throughout the program to "parameterize" certain functions. Suppose for 
example, that data received from a Teletype appears on a particular input 
port, and data is sent to the Teletype through the next output port in 
sequence. The series of equate statements could be used to define these ports 
for a particular hardware environment 



1TYBASE 


EQU 


10H ;BASE PORT NUMBER FOR TTY 


TTYIN 


EQU 


TTYBASE ;TTY DATA IN 


TIYOUT 


EQU 


TTYBASE+1 ;TTY DATA OUT 



At a later point in the program, the statements which access the Teletype 
could appear as 



IN TTYIN ;READ TTY DATA TO REG-A 

• • • 

OUT TTYOUT ;WRITE DATA TO TTY FROM REG-A 

making the program more readable than if the absolute i/o ports had been 
used. Further, if the hardware environment is redefined to start the Teletype 
communications ports at 7FH instead of 10H, the first statement need only be 
changed to 

TTYBASE EQU 7FH ;BASE PORT NUMBER FOR TTY 

and the program can be reassembled without changing any other statements, 

4.4. The SET Directive. 

The SET statement is similar to the EQU, taking the form 

label SET expression 

except that the label can occur on other SET statements within the program. 
The expression is evaluated and becomes the current value associated with the 
label. Thus, the EQU statement defines a label with a single value, while the 
SET statement defines a value which is valid from the current SET statement to 
the point where the label occurs on the next SET statement. The use of the 
SET is similar to the EQU statement, but is used most often in controlling 
conditional assembly. 

4.5. The IF and ENDIF directives. 

The IF and ENDIF statements define a range of assembly language statements 
which are to be included or excluded during the assembly process. The form is 

IF expression 

statement#l 

statement#2 

... 
statements 
ENDIF 

Upon encountering the IF statement, the assembler evaluates the expression 
following the IF (all operands in the expression must be defined ahead of the 
IF statement) , If the expression evaluates to a non-zero value, then 
statements through statements are assembled; if the expression evaluates to 
zero, then the statements are listed but not assembled. Conditional assembly 
is often used to write a single "generic" program which includes a number of 
possible run-time environments, with only a few specific portions of the 
program selected for any particular assembly. The following program segments 
for example, might be part of a program which communicates with either a 
Teletype or a CRT console (but not both) • by selecting a particular value for 
TTY before the assembly begins 
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toue: 


EQU 


0FFFFH 


FALSE 


EQU 


NOT TRUE 


TTY 


EQU 


TRJE 


TTYBASE 


EQU 


10H 


CRTBASE 


EQU 


20H 




IF 


TTY 


OONIN 


EQU 


TTYBASE 


GONOUT 


EQU 


TTYBASE+1 




ENDIF 




i 


IF 


NOT TTY 


OONIN 


EQU 


CRTBASE 


coNOtrr 


EQU 
ENDIF 


CRE'BASE+1 




• • • 
IN 


OONIN 




• • • 

our 


OONOOT 



;DEFINE VALUE OF TRUE 
; DEFINE VALUE OF FALSE 

;TROE IF TTY, FALSE IF CRT 

;BASE OF TTY I/O PORTS 

;BASE OF CRT I/O PORTS 

; ASSEMBLE RELATIVE TO TTYBASE 

;CONSOLE INPUT 

; CONSOLE OUTPUT 



ASSEMBLE RELATIVE TO CRTBASE 
CONSOLE INPUT 



CONSOLE OUTPUT 



( 



;READ CONSOLE DATA 

;WRITE CONSOLE DATA 

In this case, the program would assemble for an environment where a Teletype 
is connected, based at port 10H. The statement defining TTY could be changed 
to 

TTY EQU FALSE 

and, in this case, the program would assemble for a CRT based at port 20H. 

4.6. The DB Directive. 

The DB directive allows the programmer to define initialize storage areas 
in single precision (byte) format. The statement form is 



label DB e#l, e#2, 



e#n 



where e#l through e#n are either expressions which evaluate to 8-bit values 
(the high order eight bits must be zero) , or are ASCII strings of length no 
greater than 64 characters. There is no practical restriction on the number 
of expressions included on a single source line. The expressions are 
evaluated and placed sequentially into the machine code file following the 
last program address generated by the assembler. String characters are 
similarly placed into memory starting with the first character and ending with 
the last character. Strings of length greater than two characters cannot be 
used as operands in more complicated expressions (i.e., they must stand alone 
between the commas) . Note that ASCII characters are always placed in memory 
with the parity bit reset (0). Further, recall that there is no translation 
from lower to upper case within strings. The optional label can be used to 
reference the data area throughout the remainder of the program. Examples of 
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valid DB statements are 



data: DB 0,1,2,3,4,5 

DB data and 0ffh, 5, 377Q, 1+2+3+4 

signon: DB 'please type your name',cr ,lf ,! 

DB 'AB' SHR 8, 'C, 'DE' AND 7FH 



4.7. The DW Directive. 

The DW statement is similar to the DB statement except double precision 
(two byte) words of storage are initialized. The form is 

label DW e#l, e#2, ..., e#n 

where e#l through e#n are expressions which evaluate to 16-bit results. Note 
that ASCII strinqs of length one or two characters are allowed, but strings 
longer than two characters disallowed. In all cases, the data storage is 
consistent with the 8080 processor: the least significant byte of the 
expression is stored forst in memory, followed by the most significant byte. 
Examples are 

doub: DW 0ffefh,doub+4,signon-$, 255+255 

DW 'a', 5, 'ab', 'CD', 6 shl 8 or lib 

4.8. The DS Directive. 

The DS statement is used to reserve an area of uninitialized memory, and 
takes the form 

label DS expression 

where the label is optional. The assembler begins subsequent code generation 
after the area reserved by the DS. Thus, the DS statement given above has 
exactly the same effect as the statement 

label: EQU $ ;LABEL VALUE IS CURRENT' CODE LOCATION 
ORG $+expression ;MOVE PAST RESERVED AREA 

5. OPERATION CODES. 

Assembly language operation codes form the principal part of assembly 
language programs, and form the operation field of the instruction. In 
general, ASM accepts all the standard mnemonics for the Intel 8080 
microcomputer, which are given in detail in the Intel manual "8080 Assembly 
Language Programminq Manual." Labels are optional on each input line and, if 
included, take the value of the instruction address immediately before the 
instruction is issued. The individual operators are listed breifly in the 
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following sections for completeness, although it is understood that the Intel 
manuals should be referenced for exact operator details. In each case, 



e3 

e8 
el6 



represents a 3-bit value in the range 0-7 
which can be one of the predefined registers 
A, B, C, D, E, H, L, M, SP, or PSW. 

represents an 8-bit value in the range 0-255 

represents a 16-bit value in the range 0-65535 



which can themselves be formed from an arbitrary combination of operands and 
operators. In some cases, the operands are restricted to particular values 
within the allowable range, such as the PUSH instruction. These cases will be 
noted as they are encountered. 

In the sections which follow, each operation codes is listed in its most 
general form, along with a specific example, with a short explanation and 
special restrictions. 



5.1. Jumps, Calls, and Returns. 

The Jump, Call, and Return instructions allow several different forms 
which test the condition flags set in the 8080 microcomputer CPU. The forms 
are 



JMP el6 

JNZ el6 

JZ el6 

JNC el6 

JC el6 

JPO el6 

JPE el6 

JP el6 

JM el6 

CALL el6 

CNZ el6 

CZ el6 

CNC el6 

CC el6 

CPO el6 

CPE el6 

CP el6 

CM el6 

RST e3 



JMP LI 
JMP L2 
JMP 100H 
JNC Ll+4 
JC L3 
JPO $+8 
JPE L4 
JP GAMMA 
JM al 



CALL 

CNZ 

CZ 

CNC 

CC 

CPO 

CPE 

CP 

CM 



SI 

S2 

100H 

Sl+4 

S3 

$+8 

S4 

GAMMA 

bl$c2 



Jump 
Jump 
Jump 
Jump 
Jump 
Jump 
Jump 
Jump 
Jump 

Call 
Call 
Call 
Call 
Call 
Call 
Call 
Call 
Call 



unconditionally to label 

on non zero condition to label 

on zero condition to label 

no carry to label 

on carry to label 

on parity odd to label 

on even parity to label 

on positive result to label 

on minus to label 



subroutine 
subroutine 
subroutine 
subroutine 
subroutine 
subroutine 
subroutine 
subroutine 
subroutine 



unconditionally 
if non zero flag 
on zero flag 
if no carry set 
if carry set 
if parity odd 
if parity even 
if positive result 
if minus flag 



RST 



Programmed "restart", equivalent to 
CALL 8*e3, except one byte call 
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RET Return from subroutine 

RNZ Return if non zero flag set 

RZ Return if zero flag set 

RNC Return if no carry 

RC Return if carry flag set 

RPO Return if parity is odd 

RPE Return if parity is even 

RP Return if positive result 

RM Return if minus flag is set 

5.2. Immediate Operand Instructions. 

Several instructions are available which load single or double precision 
registers, or single precision memory cells, with constant values, along with 
instructions which perform immediate arithmetic or logical operations on the 
accumulator (register A) . 

Move immediate data to register A, B, 
C, D, E, H, L, or M (memory) 
Add immediate operand to A without carry 
Add immediate operand to A with carry 
Subtract from A without borrow (carry) 
Subtract from A with borrow (carry) 
Logical "and" A with immediate data 
"Exclusive or" A with immediate data 
Logical "or" A with immediate data 
Compare A with immediate data (same 
as SUI except register A not changed) 

Load extended immediate to register pair 
(e3 must be equivalent to B,D,H, or SP) 

5.3. Increment and Decrement Instructions. 

Instructions are provided in the 8080 repetoire for incrementing or 
decrementing single and double precision registers. The instructions are 

INR e3 INK E Single precision increment register (e3 

produces one of A, B, C, D, E, H, L, M) 
DCR e3 DCR A Single precision decrement register (e3 

produces one of A, B, C, D, E, H, L, M) 
I NX e3 INX SP Double precision increment register pair 

(e3 must be equivalent to B,D,H, or SP) 
DCX e3 DCX B Double precision decrement register pair 

(e3 must be equivalent to B,D,H r or SP) 

5.4. Data Movement Instructions. 
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MVI e3, 


e8 


MVI B,255 


ADI e8 




ADI 1 


ACI e8 




ACI 0FFH 


SUI e8 




SUI L + 3 


SBI e8 




SBI L AND 11B 


AN I e8 




AN I $ AND 7FH 


XRI e8 




XRI 1111$0000] 


ORE e8 




ORE L AND 1+1 


CPI e8 




CPI 'a' 


LXI e3, 


el6 


LXI B,100H 



Instructions which neve data from memory to the CPU and from CPU to 
memory are given below 



MOV e3,e3 MOV A,B 



LDAX e3 


LDAX 


B 


STAX e3 


STAX 


D 


LHLD el 6 


LHLD 


LI 


SHLD el6 


SHLD 


L5+x 


LDA el6 


LDA 


Gamma 


STA el6 


STA 


X3-5 


POP e3 


POP 


PSW 


PUSH e3 


PUSH 


B 


IN e8 


IN 





OUT e8 


OUT 


255 


XTHL 






PCHL 






SPHL 






XCHG 







Move data to leftmost element from right- 
most element (e3 produces one of A,B,C 
D,E,H,L, or M) . MOV M,M is disallowed 
Load register A from computed address 
(e3 must produce either B or D) 
Store register A to computed address 
(e3 must produce either B or D) 
Load HL direct from location el6 (double 
precision load to K and L) 
Store HL direct to location el6 (double 
precision store from H and L to memory) 
Load register A from address el6 
Store register A into memory at el6 
Load register pair from stack, set SP 
(e3 must produce one of B, D, H, or PSVv) 
Store register pair into stack, set SP 
(e3 must produce one of B, D, H, or PSW) 
Load register A with data from port e8 
Send data from register A to port e8 
Exchange data from top of stack with HL 
Fill program counter with data from HL 
Fill stack pointer with data from HL 
Exchange DE pair with HL pair 



5.5. Arithmetic Logic Unit Operations. 

Instructions which act upon the single precision accumulator to perform 
arithmetic and logic operations are 

Add register given by e3 to accumulator 

without carry (e3 must produce one of A, 

B, C, D, E, H, or L) 

Add register to A with carry, e3 as above 

Subtract reg e3 from A without carry, 

e3 is defined as above 

Subtract register e3 from A with carry, 

e3 defined as above 

Logical "and" reg with A, e3 as above 

"Exclusive or" with A, e3 as above 

Logical "or" with A, e3 defined as above 

Compare reqister with A, e3 as above 

Decimal adjust register A based upon last 

arithmetic logic unit operation 

Complement the bits in register A 

Set the carry flag to 1 



ADD 


e3 


ADD 


B 


ADC 


e3 


ADC 


L 


SUB 


e3 


SUB 


H 


SBB 


e3 


SBB 


2 


ANA 


e3 


ANA 


1+1 


XRA 


e3 


XRA 


A 


ORA 


e3 


ORA 


B 


CMP 


e3 


CMP 


H 


DAA 








CMA 








STC 
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CMC Complement the carry flag 

RLC Rotate bits left, (re) set carry as a side 

effect (high order A bit becomes carry) 
RRC Rotate bits right, (re) set carry as side 

effect (low order A bit becomes carry) 
RAL Rotate carry/A register to left (carry is 

involved in the rotate) 
RAR Rotate carry/A register to right (carry 

is involved in the rotate) 



DAD e3 DAD B Double precision add register pair e3 to 

HL (e3 must produce B, D, H, or SP) 

5.6. Control Instructions. 

The four remaining instructions are categorized as control instructions, 
and are listed below 

HLT Halt the 8080 processor 

DI Disable the interrupt system 

EI Enable the interrupt system 

NCP No operation 

6. ERROR MESSAGES. 

When errors occur within the assembly language program, they are listed as 
single character flags in the leftmost position of the source listing. The 
line in error is also echoed at the console so that the source listing need 
not be examined to determine if errors are present. The error codes are 

D Data error: element in data statement cannot be 
placed in the specified data area 

E Expression error: expression is ill-formed and 
cannot be computed at assembly time 

L Label error: label cannot appear in this context 
(may be duplicate label) 

N- Not implemented: features which will appear in 

future ASM versions (e.g., macros) are recognized, 
but flagged in this version) 

Overflow: expression is too complicated (i.e., too 
many pending operators) to computed, simplify it 

P Phase error: label does not have the same value on 
two subsequent passes through the program 



16 



R 



V 



Register error: the value specified as a register 
is not compatible with the operation code 

Value error: operand encountered in expression is 
improperly formed 



Several error message are printed which are due to terminal error 
conditions 



NO SOURCE FILE PRESENT 



The file specified in the ASM command does 
not exist on disk 



NO DIRECTORY SPACE 



SOURCE FILE NAME ERROR 



SOURCE FILE READ ERROR 



OUTPUT FILE WRITE ERROR 



CANNOT CLOSE FILE 



The disk directory is full, erase files 
which are not needed, and retry 

Improperly formed ASM file name (e.g., it 
is specified with "?" fields) 

Source file cannot be read properly by the 
assembler, execute a TYPE to determine the 
point of error 

Output files cannot be written properly, most 
likely cause is a full disk, erase and retry 

Output file cannot be closed, check to see 
if disk is write protected 



7. A SAMPLE SESSION. 

The following session shows interaction with the assembler and debugger in 
the development of a simple assembly language program. 



'7 



asm sort. azseMtUe. SoFT .ftSM- 



CP/M ASSEMBLER - VER 1 . 8 



&15C wxt- + fee oiA*&5> m \ 

083H USE FACTOR o/ £ H^Utf 0£&( CO fb ^F £(i4^€Ci*aaJ J 
END OF ASSEMBLY 



DIR SORT. * 



SORT 
SORT 
SORT 
SORT 
A>TYPE SORT. PRN 



ASM £0U*<t -fiU 

B A K \oucbL**j***> U*f tfdlf 

HEX v*acUi««. codCt /!(«, 



Seuurtt, l**^ 



0100 ^ 

^Muuftiexi KtfcUiK^ Code 

0180 214601V 3 SORT: 
0103 3681 
0105 214761 
0108 3660 



SORT PROGRAM IN CP/M ASSEMBLY LANGUAGE 

START AT THE BEGINNING OF THE TRANSIENT PROGRAM AR 

ORG 188H 



;ADDRESS SWITCH TOGGLE 

;SET TO 1 FOR FIRST ITERATION 

; ADDRESS INDEX 

; I = 6 



LXI 


H> SU 


MVI 


M> 1 


LXI 


H, I 


MVI 


M, 



018A 7E 
818B FE09 
810D D21981 



; COMPARE I U I T m ARRAY SIZE 

COUP: MOV A> M ;A REGISTER = I 

CPI N-l ;CY SET IF I ( (N-l) 

JNC CONT ;CONTINUE IF I <= <N-2> 



0110 214681 
0113 7EB7C20001 



END OF ONE PASS THROUGH DATA 

LXI H> SU ;CHECK FOR ZERO SWITCHES 

MOV A,M! ORA A! JN2 SORT ;END OF SORT IF SU-0 



0118 FF 




RST 7 



;GO TO THE DEBUGGER INSTEAD OF REt 



unCA' 



u 



0119 5F16802148CONT: 
0121 4E792346 



0125 23 



CONTINUE THIS PhSS 

ADDRESSING I, SO LOAD AV<I) INTO REGISTERS 

MOV E,A! MVI D,0! LXI H .. A V ! DAD D! DAD D 

MOV CM! MOV H;C! I NX H! MOV B,M 

LOU ORDER BYTE IN A AND C, HIGH ORDER BYTE IN B 

MOV H AND L TO ADDRESS AV<I+1) 
I NX H 



0126 965778239E 



COMPARE VALUE UITH REGS CONTAINING AV(I) 

SUB ft! MOV D,A! MOV A; B ! INX H! SBB (1 ;SUBTRACT 



012B DA3F01 



BORROW SET IF AV<I + 1> > AV< I ) 

JC INCI ;SKIP IF IN PROPER ORDER 



012E B2CA3F81 



CHECK FOR EQUAL VALUES 

ORA D! JZ IHCI /SKIP IF AV<I) = A V < 1 + 1 > 



I? 



6132 56702B5E 
0136 712B722B73 



MOV D,f1! MOV M,B! DCX H! MOV E , M 

MOV 11, C! DCX H! 110V M, D ! DCX H! 110V M,E 



013B 21460134 



INCREMENT SWITCH COUNT 
LXI H, SW! INR M 



013F 21470134C3INCI 



INCREMENT I 

LXI H, I ! INR M! JMP COMP 



DATA DEFINITION SECTION 



0146 00 SU: 

0147 I: 

8148 05B864001EAV: 
000A == N 

1 5 c — €4 we wctlue 
A>TYPE SORT. HEX ^ 



DB 

DS 

DM 

EQU 

END 



;RESERVE SPACE FOR SWITCH COUNT 

1 ; SPACE FOR INDEX 

5, 10 0, 3 0, 5 0, 2 0, 7, 1008, 3 9 0, 100, -32767 
<*-AV>/2 ;C0MPUTE N INSTEAD OF PRE 



180 100 00 214 60 1360121470136 00 7EFE09D2190140 

1 00 110 00 214 60 17EB7C2 00 IFF 5F 1600214801 1983 

100 12000 194E792346239657 7 8 239EDA3F0 1B2CAA7 

180 13000 3F0156702B5E712B72 2B 73214 60 1 3421 C 7 

7014000470134C3 0A01006E 

100 14 80005 006 400 1E003 20 014000 7 0E80 3 2C01BB 

0401580064000180BE 

0000000000 






J 



A>DDT SORT.HEX-> tfW+ ddsu<\ Vu/v. 

16K DDT VER 1. 

NEXT PC r • ,. / ,, ,. 

015c 0000 dehoMr address Cm add*** <* 

P*0000 100. CWk^ fC -\t> [00 



QjO sH&rccmeMrJ 






C020M0E0I0 A=00 B = 0000 D = 0000 H = 0000 S=0100 P=0180 LXI H, 0146*0100 



~T10^ 

C020M 
C028M 
C020M 
C0Z0M 
C0Z0M 
C020M 
CIZOM 
C120M 
C120M 
C120M 
C020M 
C020M 
C020M 
CO20M 
C020M 
C020M 
- A 1 D 



BE0I0 

0E0I0 
0E0I0 

0E0I0 
0E0I0 
0E0I0 
1E0I0 
1E0I0 
1E0I0 
1E0I0 
0E010 

BE0I0 

0E0I0 
0E0I0 

0E0I0 

0E0I0 



t°**H* 



A = B1 
A = 01 
A = 01 
A = 01 

A = 01 

A=00 
A = 00 

A=00 

A = 00 

A = 01 
A=01 
A = 01 
A = 01 
A = 01 
A = 01 
A = 01 



= 0000 

-0000 

= 0000 
= 0000 
= 0000 
= 0000 
= 0000 
= 0000 
= 0000 
= 0000 
= 0000 
= 0000 
= 0000 
= 0000 
= 0000 
= 00 



D=00 

D = 00 
D = 80 
D = 00 
D = 00 

D = 00 
D=B0 
D=G0 
D=00 
D = 00 
D=00 

D = 00 
D = 00 

D=0 
D=00 

D = 00 



00 H 

00 H 

00 H 

00 H 

00 H 

00 H 

00 H 

00 H 

00 H 

00 H 

00 H 

00 H 

00 H 

00 H 

00 H 

00 H 



0146 
0146 
0146 
01 47 
01 47 
01 47 
014 7 
01 47 
01 46 
01 46 
01 46 
01 46 
01 46 
81 46 
01 47 
0.1 4 7 



£ = 



01 00 

01 00 
01 00 
'0100 
01 00 
01 06 
01 00 
01 00 
01 00 
01 00 
01 00 
0100 
0100 
01 00 
01 00 
01 00 



P=0100 

P=0103 
P==0 105 
P=0 103 
P-0 10A 

P ■■'- 9 1 B 

P=0 10D 
P---811W 
P=0t 1 3 
P«011 4 
P=01 15 

P=0100 
P=0 103 

P = 1 5 

P=0108 

P = 1 A 



LXI 

MVI 
LXI 
MVI 
MOV 
CPI 
JNC 
LXI 
MOV 
ORA 
J HZ 
LXI 
MVI 
LXI 
MVI 
MOV 



0146 

01 

0147 

00 

M 



H 

M 

H 

M 

A 

9 

119 

H , 1 4 6 

A, M 

A 

0100 

H, 0146 

01 

147 



M * 1 8 B 



810D JC 
01 10 J 



ii9, cU&^c~rt> 



*J uu f 



o* ca 



"3 



5^^ at 



I? 



P=810B 



3 0, YeS£^ sproyav* OOmvC&r iodcL-h k£<jtA*\fUiCT'f<~0^fAWl 

-Tie -We e&cJw*^ (0H 5 ^f 5 



C0ZBH0E0I0 
C8Z8M0E8I0 
C0Z8M0E0I8 
C0Z0M0E0I0 
C0Z8M8E818 
C8Z8M0E8I8 
C1Z6M1E8I8 
C1Z8M1E8I8 
C1Z8M1E8I6 
C1Z8M1E8I8 
C1Z8M1E8I8 
e0Z0lilE810 
C8Z8M1E8I8 
C0Z8M1E8I0 
C8Z8M1E8I8 
C8Z6M1E8I8 
-L188. 



A = 00 

A = B8 
A = 68 
A=88 
A = 6 

A = B0 

A = 80 
A = 88 

A = 68 

A = 88 
A = 00 
A = 00 

A = 

A = 08 
A = 05 
A = 65 



6=8886 
B=0808 
B=6888 
B=8668 

B=88B6 

B=B000 

B=0000 
B=0000 

B=8000 
B=0090 
B=8080 
B=0080 
B=0808 
B=0005 
B=8005 
B=0005 



D=0 00 

D=0 80 
D=B800 

D=0900 
D=0000 

D=0800 

D-0000 
D=0 00 
B=0000 

D=0008 
D=0000 
D=8088 
D=8888 

D=8 8 08 

D=8 8 00 

D=0880 



H=8147 
H=8146 
H=0146 
H = 1 4 1 
H=814? 
H=0147 
H=8147 
H=0147 
H=8147 
H=014? 
H=0148 
H=0148 
H=0143 
H=8148 
H = 81 48 
H=81 49 



S=01 00 
S=0180 

8=8180 

S=01 00 
8=0100 

3=0100 

S=81 00 
8=01 08 

8=0108 
S=0100 
8=0100 
S=0100 

8 = 8 1 8 8 
S = 8 1 8 
8=0188 

S=01 80 



P=0100 

P=8 183 
P=0 185 
P=0 188 
P=0 18A 

P=0 10B 

P=810D 
P=0U9 
P=8 1 1 A 
P=0ll C 
P=011F 
P=0120 
P=8121 
P^8i22 
P=8 123 
P=0 124 



LXI 

11 VI 

LXI 

MVI 

110 V 

CP1 

JC 

MOV 

MVI 

LXI 

DAD 

DAD 

MOV 

MOV 

I NX 

MOV 



0108 
0103 
0185 

0108 

010A 
016B 

010D 

81 18 
81 13 
01 14 
8115 

-L -> 



LXI 

MVI 

LXI 

MVI 

MOV 

CPI 

JC 

LXI 

MOV 

ORA 

JNZ 



8118 RST 

8119 MOV 
8 1 I A MVI 
811C LXI 



H.0146 ^ 

M, 01 

H, 0147 

M, 00 

A, M 

09 

0119 

H, 0146 

A, M 

A 

8 100 



07 \ list- 

E, A 
B, 00 
H, 148 






\ list Some co< 



wwre 



H, 0146 
M , 8 1 
H, 8147 
M , 8 
A, M 
09 

0119 
E, A 
D, 8 8 
H , 1 4 8 
D 
D 



^ 



J 



v«A 



#> 



*> 



V" 



C 

M*B1 25 



4-o I I6M 



-G, 1 18^ sWt yoafMA.\<w»- cwrv0sx 

•5-W^t u^+U awt ex\prv*A (utter mp+ 7 -fflfcu ;WI JV*el (froyaui u**s 



*0127 
-T4 



a c a t a a — •? o D-aar ii n — a a a c u.amc o - a i & a d - a i o 7 mau 



C0Z8M8E0I8 
C0Z0M0E010 
C0Z0M0E0I0 
C0Z8M0E8I8 
-B148 



A = 38 
A = 38 
A = 88 

A = 8 8 



B=8864 
B=8864 
B=8864 

B ■ - 8 fa 4 



D=8006 
D=3806 
D=3 8 86 
B=3 8 06 



H=0156 
H=0156 
H=01 56 
H = 8 1 5 7 



8=0100 

8=0108 

5=0106 

S = 8 1 8 



P=0127 

P=012S 
P ■■- & 1 2 9 
P = 1 2 A 



MOV 
MOV 
INK 
SBB 



D, A 
A, B 

H 

M * 1 2 B 



148 
0150 

01 60 



05 

32 

00 



00 
00 

00 



07 
64 

00 



00 
00 
00 



14 
64 
00 



00 

80 
00 



IE 
2C 
00 



00 

01 

00 



c oUfec i£ ^oAed, bixt ^voyaw- ^oes^f Stc'P • 



E8 

00 



3 

I,. >.i 



01 
00 



80 

00 



00 

80 



00 

00 



00 

00 



80 

00 



2 D. D 



10 



~€< yeW*. *ta C?/u 



DDT SORT. HEX -, reload Ma£ mctvuvu \*y\(kg£ 



16K DDT VER 1. 8 
NEXT PC 
015C 0606 
-XP 



P = 0800 100j S^irfC 4o t^mviny tf^Wi 



810D JNC 0119" 7 
0110 LXI H , 1 4 6 

" ^W+ U^i" wvAU rub out 
010D JC 113, 

01 10, 

• - P 

-L160 ^ sWr+Vtt S^OU** or ^/ayst**- 

8108 LXI H,0146 

8 18 3 M VI M , 8 1 

0105 LXI H,0147 

8108 MVI M,88 

-A 193^ d^" l Wc(/ ^^ ^ ^ 

8 103 MVI M,0j 

8 105^ 

--C reWt--VCF/K u/tU, a{U (G0 \»ofe as u>elf) 

SAVE 1 S0RT.COM , $AU£ 1 f^ Cz^ WjUs,<f«*^ lOOH-blR^O 6YV <^*fc vCv C*S^ 

A>DDT S0RT.COM. r^W* T^ T ^*VU 

16K DDT VER 1.0 

0288 8 108 <W ll le «W*3* STwri •" <-~~* 

♦ 8118 -ovtxjf(x«AM^«A 5^p <Tfcsr7) eiA^u-4-^ 

8148 05 80 0? 08 14 08 IE 0^ 



8150 32 88 64 88 64 08 2C 81 E8 83 01 80 08 80 88 08 2 D.D 

8160 80 88 88 80 88 00 80 88 80 00 8 8 8 6 88 8 8 08 

0170 88 88 00 08 88 88 80 88 80 80 88 80 88 88 88 80 



- Gtfj r eW<^ 4o OS /M> z ( 



ED SORT. ASM ^ /watt cUx^S -\o &r\A\v&\ -Pv&yO.*^ 

* n , er 2)0 t y 4i\M ^ '>* 

^ M V I M , ; I = 6 

\ LXI H, I ;ADDRESS INDEX 

* - ) up tfirtfrfUer tine 

MVI M, 1 ;SET TO 1 FOR FIRST ITERATION 

* K T, ViU {<*. 6*k -W **** ^ 

LXI H, I >ADDRESS INDEX 

* I \ tv«M **** U»v^ 

MVI M,8 ;ZER0 SU 

_^ LXI H, I ;ADDRESS INDEX 
*NJNdQ_50T^ 

J.NC*T> 

COHT ^CONTINUE IF I <= <N-2> 



*-2DIC(^2)&LT^ 

JC C.ONT ^CONTINUE IF I <= <N-2> 

* *V r $<>*& Won diik A 

ASM SORT. A A ZjT"5kv|J ?™ -h 1 * 
CP/M ASSEMBLER - VER 1 . 8 

883H USE FACTOR 
END OF ASSEMBLY 

PDT SORT. HEX, ^ payawu cluuy* 

16K DDT VER i. 8 
NEXT PC 
8 1 5 C 8 8 86 
- G 1 8 8j 

* 8 1 1 6 

0148 05 08 87 88 14 88 IE 88 

8158 32 88 64 80 64 88 2C 81 E8 03 81 80 88 88 08 082.D.D.,.. 

8 168 8 6 8 88 08 8 00 8 6 8 8 8 8 



-G8 ; reVoc-ro CP/m^-^W*ua. deck* 0£ 



ZZ 
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1. INTRODUCTION. 

This manual describes CP/M, release 2, system organization 
including the structure of memory and system entry points. The 
intention is to provide the necessary information required to write 
programs which operate under CP/M r and which use the peripheral and 
disk I/O facilities of the system. 

CP/M is logically divided into four parts, called the Basic I/O 
System (BIOS) , the Basic . Disk Operating System (BDOS) , the Console 
command processor (CCP) , and the Transient Program Area (TPA) . The 
BIOS is a hardware-dependent module which defines the exact low level 
interface to a particular computer system which is necessary for 
peripheral device I/O. Although a standard BIOS is supplied by 
Digital Research, explicit instructions are provided for field 
reconfiguration of the BIOS to match nearly any hardware environment 
(see the Digital Research manual entitled "CP/M Alteration Guide"). 
The BIOS and BDOS are logically combined into a single module with a 
common entry point, and referred to as the FDOS. The CCP is a 
distinct program which uses the FDOS to provide a human-oriented 
interface to the information which is cataloged on the backup storage 
device. The TPA is an area of memory (i.e., the portion which is not 
used by the FDOS and CCP) where various non-resident operating system 
commands and user programs are executed. The lower portion of memory 
is reserved for system information and is detailed later sections. 
Memory organization of the CP/M system in shown below: 



high 
memory 

FBASE: 



CBASE: 



TBASE: 



BOOT: 



1 FDOS 


(BDOS+BIOS) 1 


1 CCP 1 


1 TPA I 


1 system parameters 1 



The exact memory addresses corresponding to BOOT, TBASE, CBASE, and 
FBASE vary from version to version, and are described fully in the 
"CP/M Alteration Guide." All standard CP/M versions, however, assume 
BOOT = 0000H, which is the base of random access memory. The machine 
code found at location BOOT performs a system "warm start" which loads 
and initializes the programs and variables necessary to return control 
to the CCP. Thus, transient programs need only jump to location BOOT 
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to return control to CP/M at the command level. Further, the standard 
versions assume TBASE = BOOT+0100H which is normally location 0100H. 
The principal entry point to the FDOS is at location BOOT+0005H 
(normally 0005H) where a jump to FBASE is found. The address field at 
BOOT+0006H (normally 0006H) contains the value of FBASE and can be 
used to determine the size of available memory, assuming the CCP is 
being overlayed by a transient program. 

Transient programs are loaded into the TPA and executed as 
follows. The operator communicates with the CCP by typing command 
lines following each prompt. Each command line takes one of the 
forms : 

command 
command filel 
command filel file2 

where "command" is either a built-in function such as DIR or TYPE, or 
the name of a transient command or program. If the command is a 
built-in function of CP/M, it is executed immediately. Otherwise, the 
CCP searches the currently addressed disk for a file by the name 

command.COM 

If the file is found, it is assumed to be a memory image of a program 

which executes in the TPA, and thus implicitly originates at TBASE in 

memory. The CCP loads the COM file from the disk into memory starting 
at TBASE and possibly extending up to CBASE. 

If the command is followed by one or two file specifications, 
the CCP prepares one or two file control block (FCB) names in the 
system parameter area. These optional FCB's are in the form necessary 
to access files through the FDOS, and are described in - the next 
section. 

The transient program receives control from the CCP and begins 
execution, perhaps using the I/O facilities of the FDOS. The 
transient program is "called" from the CCP, and thus can simply return 
to the CCP upon completion of its processing, or can jump to BOOT to 
pass control back to CP/M. In the first case, the transient program 
must not use memory above CBASE, while in the latter case, memory up 
through FBASE-1 is free. 

The transient program may use the CP/M I/O facilities to 
communicate with the operator's console and peripheral devices, 
including the disk subsystem. The I/O system is accessed by passing a 
"function number" and an "information address" to CP/M through the 
FDOS entry point at BOOT+0005H. In the case of a disk read, for 
example, the transient program sends the number corresponding to a 
disk read, along with the address of an FCB to the CP/M FDOS. The 
FDOS, in turn, performs the operation and returns with either a disk 
read completion indication or an error number indicating that the disk 
read was unsuccessful. The function numbers and error indicators are 
given in below. 
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2. OPERATING SYSTEM CALL CONVENTIONS. 

The purpose of this section is to provide detailed information 
for performing direct operating system calls from user programs. Many 
of the functions listed below, however, are more simply accessed 
through the I/O macro library provided with the MAC macro assembler, 
and listed in the Digital Research manual entitled "MAC Macro 
Assembler: Language Manual and Applications Guide." 

CP/M facilities which are available for access by transient 
programs fall into two general categories: simple device I/O, and 
disk file I/O. The simple device operations include: 

Read a Console Character 

Write a Console Character 

Read a Sequential Tape Character 

Write a Sequential Tape Character 

Write a List Device Character 

Get or Set I/O Status 

Print Console Buffer 

Read Console Buffer 

Interrogate Console Ready 

The FDOS operations which perform disk Input/Output are 

Disk System Reset 

Drive Selection 

File Creation 

File Open 

File Close 

Directory Search 

File Delete 

File Rename 

Random or Sequential Read 

Random or Sequential Write 

Interrogate Available Disks 

Interrogate Selected Disk 

Set DMA Address 

Set/Reset File Indicators 

As mentioned above, access to the FDOS functions is accomplished 
by passing a function number and information address through the 
primary entry point at location BOOT+0005H. In general, the function 
number is passed in register C with the information address in the 
double byte pair DE. Single byte values are returned in register A, 
with double byte values returned in HL (a zero value is returned when 
the function number is out of range) . For reasons of compatibility, 
register A = L and register B = H upon return in all cases. Note that 
the register passing conventions of CP/M agree with those of Intel's 
PL/M systems programming language. The list of CP/M function numbers 
is given below. 
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System Reset 

1 Console Input 

2 Console Output 

3 Reader Input 

4 Punch Output 

5 List Output 

6 Direct Console I/O 

7 Get I/O Byte 

8 Set I/O Byte 

9 Print String 

10 Read Console Buffer 

11 Get Console Status 

12 Return Version Number 

13 Reset Disk System 

14 Select Disk 

15 Open File 

16 Close File 

17 Search for First 

18 Search for Next 



19 Delete File 

20 Read Sequential 

21 Write Sequential 

22 Make File 

23 Rename File 

24 Return Login Vector 

25 Return Current Disk 

26 Set DMA Address 

27 Get Addr(Alloc) 

28 Write Protect Disk 

29 Get R/O Vector 

30 Set File Attributes 

31 Get Addr(Disk Parms) 

32 Set/Get User Code 
3 3 Read Random 

34 Write Random 

35 Compute File Size 

36 Set Random Record 



(Functions 28 and 32 should be avoided in 
maintain upward compatibility with MP/M.) 



application programs to 



Upon entry to a transient program, the CCP leaves the stack 
pointer set to an eight level stack area with the CCP return address 
pushed onto the stack, leaving seven levels before overflow occurs. 
Although this stack is usually not used by a transient program (i.e., 
most transients return to the CCP though a jump to location 0000H) , it 
is sufficiently large to make CP/M system calls since the FDOS 
switches to a local stack at system entry. The following assembly 
language program segment, for example, reads characters continuously 
until an asterisk is encountered, at which time control returns to the 
CCP (assuming a standard CP/M system with BOOT = 0000H) : 

; STANDARD CP/M ENTRY 
;CONSOLE INPUT FUNCTION 

;BASE OF TPA 

;READ NEXT CHARACTER 

; RETURN CHARACTER IN <A> 

;END OF PROCESSING? 

;LOOP IF NOT 

; RETURN TO CCP 

CP/M implements a named file structure on each disk, providing a 
logical organization which allows any particular file to contain any 
number of records from completely empty, to the full capacity of the 
drive. Each drive is logically distinct with a disk directory and 
file data area. The disk file names are in three parts: the drive 
select code, the file name consisting of one to eight non-blank 
characters, and the file type consisting of zero to three non-blank 
characters. The file type names the generic category of a particular 
file, while the file name distinguishes individual files in each 
category. The file types listed below name a few generic categories 
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which have been established, although they are generally arbitrary: 

ASM Assembler Source PLI PL/I Source File 

PRN Printer Listing REL Relocatable Module 

HEX Hex Machine Code TEX TEX Formatter Source 

BAS Basic Source File BAK ED Source Backup 

INT Intermediate Code SYM SID Symbol File 

COM CCP Command File $$$ Temporary File 

Source files are treated as a sequence of ASCII characters, where each 
"line" of the source file is followed by a carriage-return line-feed 
sequence (0DH followed by 0AH) . Thus one 128 byte CP/M record could 
contain several lines of source text. The end of an ASCII file is 
denoted by a control-Z character (1AH) or a real end of file, returned 
by the CP/M read operation. Control-Z characters embedded within 
machine code files (e.g., COM files) are ignored, however, and the end 
of file condition returned by CP/M is used to terminate read 
operations. 

Files in CP/M can be thought of as a sequence of up to 65536 
records of 128 bytes each, numbered from through 65535, thus 
allowing a maximum of 8 megabytes per file. Note, however, that 
although the records may be considered logically contiguous, they may 
not be physically contiguous in the disk data area. Internally, all 
files are broken into 16K byte segments called logical extents, so 
that counters are easily maintained as 8-bit values. Although the 
decomposition into extents is discussed in the paragraphs which 
follow, they are of no particular consequence to the programmer since 
each extent is automatically accessed in both sequential and random 
access modes. 

In the file operations starting with function number 15, DE 
usually addresses a file control block (FCB) . Transient programs 
often use the default file control block area reserved by CP/M at 
location BOOT+005CH (normally 005CH) for simple file operations. The 
basic unit of file information is a 128 byte record used for all file 
operations, thus a default location for disk I/O is provided by CP/M 
at loca.tion BOOT+0080H (normally 0080H) which is the initial default 
DMA address (see function 26) . All directory operations take place in 
a reserved area which does not affect write buffers as was the case in 
release 1, with the exception of Search First and Search Next, where 
compatibility is required. 

The File Control Block (FCB) data area consists of a sequence of 

33 bytes for sequential access and a series of 36 bytes in the case 

that the file is accessed randomly. The default file control block 

normally located at 005CH can be used for random access files, since 

the three bytes starting at BOOT+007DH are available for this purpose. 
The FCB format is shown with the following fields: 
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|dr|fl|f2|/ /| f8| t-1 1 12| t3 lexlsl | s2 |rc|d0 1/ /|dn|cr |r0 I rl| r2 I 
00 01 02 ... 08 09 10 11 12 13 14 15 16 ... 31 32 33 34 35 
where 

dr drive code (0 - 16) 

=> use default drive for file 

1 => auto disk select drive A, 

2 => auto disk select drive B, 
• • • 

16=> auto disk select drive P. 

fl...f8 contain the file name in ASCII 
upper case, with high bit = 

tl,t2,t3 contain the file type in ASCII 
upper case, with high bit = 
tl*, t2', and t3' denote the 
bit of these positions, 
tl' = 1 => Read/Only file, 
t2* = 1 => SYS file, no DIR list 

ex contains the current extent number, 
normally set to 00 by the user, but 
in range - 31 during file I/O 

si reserved for internal system use 

s2 reserved for internal system use, set 
to zero on call to OPEN, MAKE, SEARCH 

re record count for extent "ex," 
takes on values from - 128 

d0...dn filled-in by CP/M, reserved for 
system use 

cr current record to read or write in 

a sequential file operation, normally 
set to zero by user 

r0,rl,r2 optional random record number in the 
range 0-65535, with overflow to r2, 
r0,rl constitute a 16-bit value with 
low byte r0, and high byte rl 

Each file being accessed through CP/M must have a corresponding 
FCB which provides the name and allocation information for all 
subsequent file operations. When accessing files, it is the 
programmer's responsibility to fill the lower sixteen bytes of the FCB 
and initialize the "cr" field. Normally, bytes 1 through 11 are set 
to the ASCII character values for the file name and file type, while 
all other fields are zero. 
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FCB's are stored in a directory area of the disk, and are 
brought into central memory before proceeding with file operations 
(see the OPEN and MAKE functions) . The memory copy of the FCB is 
updated as file operations take place and later recorded permanently 
on disk at the termination of the file operation (see the CLOSE 
command) . 

The CCP constructs the first sixteen bytes of two optional FCB's 
for a transient by scanning the remainder of the line following the 
transient name, denoted by "filel" and "file2" in the prototype 
command line described above, with unspecified fields set to ASCII 
blanks. The first FCB is constructed at location BOOT+005CH, and can 
be used as-is for subsequent file operations. The second FCB occupies 
the d0 ... dn portion of the first FCB, and must be moved to another 
area of memory before use. If, for example, the operator types 

PROGNAME BrX.ZOT Y.ZAP 

the file PROGNAME.COM is loaded into the TPA, and the default FCB at 
BOOT+0 5CH is initialized to drive code 2, file name "X" and file type 
"ZOT". The second drive code takes the default value 0, which is 
placed at BOOT+006CH, with the file name "Y" placed into location 
BOOT+006DH and file type "ZAP" located 8 bytes later at BOOT+0075H. 
All remaining fields through "cr" are set to zero. Note again that it 
is the programmer's responsibility to move this second file name and 
type to another area, usually a separate file control block, before 
opening the file which begins at BOOT+005CH, due to the fact that the 
open operation will overwrite the second name and type. 

If no file names are specified in the original command, then the 
fields beginning at BOOT+005DH and BOOT+006DH contain blanks. In all 
cases, the CCP translates lower case alphabetics to upper case to be 
consistent with the CP/M file naming conventions. 

As an added convenience, the default buffer area at location 
BOOT+0080H is initialized to the command line tail typed by the 
operator following the program name. The first position contains the 
number of characters, with the characters themselves following the 
character count. Given the above command line, the area beginning at 
BOOT+0080K is initialized as follows: 

BOOT+0 80H: 

+00 +01 +02 +03 +04 +05 +06 +07 +08 +09 +10 +11 +12 +13 +14 
14 B" " : " "X" "." "Z" "0" "T y" "." "Z" "A" "P" 

where the characters are translated to upper case ASCII with 
uninitialized memory following the last valid character. Again, it is 
the responsibility of the programmer to extract the information from 
this buffer before any file operations are performed, unless the 
default DMA address is explicitly changed. 

The individual functions are described in detail in the pages 
which follow. 
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*************************************** 

* * 

* FUNCTION 0: System Reset * 

* * 

*************************************** 

* Entry Parameters: * 

* Register C: 00H * 
*************************************** 



The system reset function returns control to the CP/M operating 
system at the CCP level. The CCP re-initializes the disk subsystem by 
selecting and logging-in disk drive A. This function has exactly the 
same effect as a jump to location BOOT. 



*************************************** 

* * 

* FUNCTION 1: CONSOLE INPUT * 

* * 
*************************************** 

* Entry Parameters: * 

* Register C: 01H * 

* * 

* Returned Value: * 

* Register A: ASCII Character * 
*************************************** 



The console input function reads the next console character to 
register A. Graphic characters, along with carriage return, line 
feed, and backspace (ctl-H) are echoed to the console. Tab characters 
(ctl-I) are expanded in columns of eight characters. A check is made 
for start/stop scroll (ctl-S) and start/stop printer echo (ctl-P) . 
The FDOS does not return to the calling program until a character has 
been typed, thus suspending execution if a character is not ready. 



*************************************** 

* * 

* FUNCTION 2: CONSOLE OUTPUT * 

* * 

*************************************** 

* Entry Parameters: * 

* Register C: 02H * 

* Register E: ASCII Character * 

* * 

*************************************** 



The ASCII character from register E is sent to the console 
device. Similar to function 1, tabs are expanded and checks are made 
for start/stop scroll and printer echo. 



(All Information Contained Herein is Proprietary to Digital Research.) 

8 



*************************************** 

* * 

* FUNCTION 3: READER INPUT * 

* * 

*************************************** 

* Entry Parameters: * 

* Register C: 03H * 

* * 

* Returned Value: * 

* Register A: ASCII Character * 
*************************************** 



The Reader Input function reads the next character from the 
logical reader into register A (see the IOBYTE definition in the "CP/M 
Alteration Guide"). Control does not return until the character has 
been read. 



*************************************** 

* * 

* FUNCTION 4: PUNCH OUTPUT * 

* * 

*************************************** 

* Entry Parameters: * 



* Register C 

* Register E 



4H * 

ASCII Character * 
* * 

*************************************** 



The Punch Output function sends the character from register E to 
the logical punch device. 



*************************************** 

* * 

* FUNCTION 5: LIST OUTPUT * 

* * 

*************************************** 

* Entry Parameters: * 

* Register C: 05H * 

* Register E: ASCII Character * 

* * 

*************************************** 



The List Output function sends the ASCII character in register E 
to the logical listing device. 
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*************************************** 

* * 

* FUNCTION 6: DIRECT CONSOLE I/O * 

* * 

*************************************** 

* Entry Parameters: * 

* Register C: 06H * 

* Register E: 0FFH (input) or * 

* char (output) * 

* * 

* Returned Value: * 

* Register A: char or status * 

(no value) * 

*************************************** 

Direct console I/O is supported under CP/M for those specialized 
applications where unadorned console input and output is required. 
Use of this function should, in general, be avoided since it bypasses 
all of CP/M's normal control character functions (e.g., control-S and 
control-P) . Programs which perform direct I/O through the BIOS under 
previous releases of CP/M, however, should be changed to use direct 
I/O under BDOS so that they can be fully supported under future 
releases of MP/M and CP/M. 

Upon entry to function 6, register E either contains hexadecimal 
FF, denoting a console input request, or register E contains an ASCII 
character. If the input value is FF, then function 6 returns A = 00 
if no character is ready, otherwise A contains the next console input 
character. 

If the input value in E is not FF, then function 6 assumes that 
E contains a valid ASCII character which is sent to the console. 
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*************************************** 

* * 

* FUNCTION 7: GET I/O BYTE * 

* * 

*************************************** 

* Entry Parameters: * 

* Register C: 07H * 

* * 

* Returned Value: * 

* Register A: I/O Byte Value * 
*************************************** 



The Get I/O Byte function returns the current value of IOBYTE in 
register A. See the "CP/M Alteration Guide" for IOBYTE definition. 



*************************************** 

* * 

* FUNCTION 8: SET I/O BYTE * 

* * 

*************************************** 

* Entry Parameters: * 

* Register C: 08H * 

* Register E: I/O Byte Value * 

* * 

*************************************** 



The Set I/O Byte function changes the system IOBYTE value to 
that given in register E. 



*************************************** 

* * 

* FUNCTION 9: PRINT STRING * 

* * 

*************************************** 

* Entry Parameters: * 

* Register C: 09H * 

* Registers DE : String Address * 

* * 

*************************************** 



The Print String function sends the character string stored in 

memory at the location given by DE to the console device, until a "$" 

is encountered in the string. Tabs are expanded as in function 2, and 
checks are made for start/stop scroll and printer echo. 
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*************************************** 

* * 

* FUNCTION 10: READ CONSOLE BUFFER * 

* * 

*************************************** 

* Entry Parameters: * 

* Register C: 0AH * 

* Registers DE: Buffer Address * 

* * 

* Returned Value: * 

* Console Characters in Buffer * 
*************************************** 

The Read Buffer function reads a line of edited console input 
into a buffer addressed by registers DE. Console input is terminated 
when either the input buffer overflows. The Read Buffer takes the 
form: 

DE: +0 +1 +2 +3 +4 +5 +6+7+8 ... +n 

Imx|nc|cl|c2|c3|c4|c5|c6|c7| . . . |??| 



where "mx" is the maximum number of characters which the buffer will 
hold (1 to 255) , "nc" is the number of characters read (set by FDOS 
upon return) , followed by the characters read from the console. if nc 
< mx, then uninitialized positions follow the last character, denoted 
by "??» i n the above figure. A number of control functions are 
recognized during line editing: 

rub/del removes and echoes the last character 

ctl-C reboots when at the beginning of line 

ctl-E causes physical end of line 

ctl-H backspaces one character position 

ctl-J (line feed) terminates input line 

ctl-M (return) terminates input line 

ctl-R retypes the current line after new line 

ctl-U removes currnt line after new line 

ctl-x backspaces to beginning of current line 

Note also that certain functions which return the carriage to the 
leftmost position (e.g., ctl-X) do so only to the column position 
where the prompt ended (in earlier releases, the carriage returned to 
the extreme left margin) . This convention makes operator data input 
and line correction more legible. 
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*************************************** 

* * 

* FUNCTION 11: GET CONSOLE STATUS * 

* * 

*************************************** 

* Entry Parameters: * 

* Register C: 0BH * 

* * 

* Returned Value: * 

* Register A: Console Status * 
*************************************** 

The Console Status function checks to see if a character has 
been typed at the console. If a character is ready, the value 0FFH is 
returned in register A. Otherwise a 00H value is returned. 

*************************************** 

* * 

* FUNCTION 12: RETURN VERSION NUMBER * 

* * 

*************************************** 

* Entry Parameters: * 

* Register C: 0CH * 

* * 

* Returned Value: * 

* Registers HL: Version Number * 
*************************************** 

Function 12 provides information which allows version 
independent programming. A two-byte value is returned, with H = 00 
designating the CP/M release (H = 01 for MP/M) , and L = 00 for all 
releases previous to 2.0. CP/M 2.0 returns a hexadecimal 20 in 
register L, with subsequent version 2 releases in the hexadecimal 
range 21, 22, through 2F. Using function 12, for example, you can 
write application programs which provide both sequential and random 
access functions, with random access disabled when operating under 
early releases of CP/M. 
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*************************************** 

* * 

* FUNCTION 13: RESET DISK SYSTEM * 

* * 
*************************************** 

* Entry Parameters: * 

* Register C: 0DH * 

* * 

*************************************** 

The Reset Disk Function is used to programmatically restore the 
file system to a reset state where all disks are set to read/write 
(see functions 28 and 29) , only disk drive A is selected, and the 
default DMA address is reset to BOOT+0080H. This function can be 
used, for example, by an application program which requires a disk 
change without a system reboot. 



*************************************** 

* * 

* FUNCTION 14: SELECT DISK * 

* * 

*************************************** 

* Entry Parameters: * 

* Register C: 0EH * 

* Register E: Selected Disk * 

* * 

*************************************** 

The Select Disk function designates the disk drive named in 
register E as the default disk for subsequent file operations, with E 
= for drive A, 1 for drive B, and so-forth through 15 corresponding 
to drive P in a full sixteen drive system. The drive is placed in an 
"on-line" status which, in particular, activates its directory until 
the next cold start, warm start, or disk system reset operation. If 
the disk media is changed while it is on-line, the drive automatically 
goes to a read/only status in a standard CP/M environment (see 
function 28). FCB's which specify drive code zero (dr = 00H) 
automatically reference the currently selected default drive. Drive 
code values between 1 and 16, however, ignore the selected default 
drive and directly reference drives A through P. 
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*************************************** 

* * 

* FUNCTION 15: OPEN FILE * 

* * 

*************************************** 

* Entry Parameters: * 

* Register C: 0FH * 

* Registers DE: FCB Address * 

* * 

* Returned Value: * 

* Register A: Directory Code * 
*************************************** 

The Open File operation is used to activate a file which 
currently exists in the disk directory for the currently active user 
number. The FDOS scans the referenced disk directory for a match in 
positions 1 through 14 of the FCB referenced by DE (byte si is 
automatically zeroed) , where an ASCII question mark (3FH) matches any 
directory character in any of these positions. Normally, no question 
marks are included and, further, bytes "ex" and "s2" of the FCB are 
zero. 

If a directory element is matched, the relevant directory 
information is copied into bytes d0 through dn of the FCB, thus 
allowing access to the files through subsequent read and write 
operations. Note that an existing file must not be accessed until a 
sucessful open operation is completed. Upon return, the open function 
returns a "directory code" with the value through 3 if the open was 
successful, or 0FFH (255 decimal) if the file cannot be found. If 
question marks occur in the FCB then the first matching FCB is 
activated. Note that the current record ("cr") must be zeroed by the 
program if the file is to be accessed sequentially from the first 
record. 
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*************************************** 

* * 

* FUNCTION 16: CLOSE FILE * 

* * 

*************************************** 

* Entry Parameters: * 

* Register C: 10H * 

* Registers DE: FCB Address * 

* * 

* Returned Value: * 

* Register A: Directory Code * 
*************************************** 

The Close File function performs the inverse of the open file 
function. Given that the FCB addressed by DE has been previously 
activated through an open or make function (see functions 15 and 22) , 
the close function permanently records the new FCB in the referenced 
disk directory. The FCB matching process for the close is identical 
to the open function. The directory code returned for a successful 
close operation is 0, 1, 2, or 3, while a 0FFH (255 decimal) is 
returned if the file name cannot be found in the directory. A file 
need not be closed if only read operations have taken place. If write 
operations have occurred, however, the close operation is necessary to 
permanently record the new directory information. 



(All Information Contained Herein is Proprietary to Digital Research.) 

16 



*************************************** 

* * 

* FUNCTION 17: SEARCH FOR FIRST * 

* * 

*************************************** 

* Entry Parameters: * 

* Register C: 11H * 

* Registers DE: FCB Address * 

* * 

* Returned Value: * 

* Register A: Directory Code * 
*************************************** 



Search First scans the directory for a match with the file given 
by the FCB addressed by DE. The value 255 (hexadecimal FF) is 
returned if the file is not found, otherwise 0, 1, 2, or 3 is returned 
indicating the file is present. In the case that the file is found, 
the current DMA address is filled with the record containing the 
directory entry, and the relative starting position is A * 32 (i.e., 
rotate the A register left 5 bits, or ADD A five times) . Although not 
normally required for application programs, the directory information 
can be extracted from the buffer at this position. 

An ASCII question mark (63 decimal, 3F hexadecimal) in any 
position from "fl" through "ex" matches the corresponding field of any 
directory entry on the default or auto-selected disk drive. If the 
"dr" field contains an ASCII question mark, then the auto disk select 
function is disabled, the default disk is searched, with the search 
function returning any matched entry, allocated or free, belonging to 
any user number. This latter function is not normally used by 
application programs, but does allow complete flexibility to scan all 
current directory values. If the "dr" field is not a question mark, 
the "s2" byte is automatically zeroed. 



*************************************** 

* * 

* FUNCTION 18: SEARCH FOR NEXT * 

* * 

*************************************** 

* Entry Parameters: * 

* Register C: 12H * 

* Returned Value: * 

* Register A: Directory Code * 
*************************************** 

The Search Next function is similar to the Search First 
function, except that the directory scan continues from the last 
matched entry. Similar to function 17, function 18 returns the 
decimal value 255 in A when no more directory items match. 
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*************************************** 

* * 

* FUNCTION 19: DELETE FILE * 

* * 
*************************************** 

* Entry Parameters: * 

* Register C: 13H * 

* Registers DE: FCB Address * 

* * 

* Returned Value: * 

* Register A: Directory Code * 
*************************************** 

The Delete File function removes files which match the FCB 
addressed by DE. The filename and type may contain ambiguous 
references (i.e., question marks in various positions), but the drive 
select code cannot be ambiguous, as in the Search and Search Next 
functions. 

Function 19 returns a decimal 255 if the referenced file or 
files cannot be found, otherwise a value in the range to 3 is 
returned. 



*************************************** 

* * 

* FUNCTION 20: READ SEQUENTIAL * 

* * 

*************************************** 

* Entry Parameters: * 

* Register C: 14H * 

* Registers DE: FCB Address * 

* * 

* Returned Value: * 

* Register A: Directory Code * 
*************************************** 

Given that the FCB addressed by DE has been activated through an. 
open or make function (numbers 15 and 22) , the Read Sequential 
function reads the next 128 byte record from the file into memory at 
the current DMA address. the record is read from position "cr" of the 
extent, and the "cr" field is automatically incremented to the next 
record position. If the "cr" field overflows then the next logical 
extent is automatically opened and the "cr" field is reset to zero in 
preparation for the next read operation. The value 00H is returned in 
the A register if the read operation was successful, while a non-zero 
value is returned if no data exists at the next record position (e.g., 
end of file occurs) . 
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*************************************** 

* * 

* FUNCTION 21: WRITE SEQUENTIAL * 

* * 

*************************************** 

* Entry Parameters: * 

* Register C: 15H * 

* Registers DE: FCB Address * 

* * 

* Returned Value: * 

* Register A: Directory Code * 
*************************************** 

Given that the FCb addressed by DE has been activated through an 
open or make function (numbers 15 and 22) , the Write Sequential 
function writes the 128 byte data record at the current DMA address to 
the file named by the FCB. the record is placed at position "cr" of 
the file, and the "cr" field is automatically incremented to the next 
record position. If the "cr" field overflows then the next logical 
extent is automatically opened and the "cr" field is reset to zero in 
preparation for the next write operation. Write operations can take 
place into an existing file, in which case newly written records 
overlay those which already exist in the file. Register A = 00H upon 
return from a successful write operation, while a non-zero value 
indicates an unsuccessful write due to a full disk. 



*************************************** 

* * 

* FUNCTION 22: MAKE FILE * 

* * 
*************************************** 

* Entry Parameters: * 

* Register C: 16H * 

* Registers DE: FCB Address * 

* * 

* Returned Value: * 

* Register A: Directory Code * 
*************************************** 

The Make File operation is similar to the open file operation 
except that the FCB must name a file which does not exist in the 
currently referenced disk directory (i.e., the one named explicitly by 
a non-zero "dr" code, or the default disk if "dr" is zero) . The FDOS 
creates the file and initializes both the directory and main memory 
value to an empty file. The programmer must ensure that no duplicate 
file names occur, and a preceding delete operation is sufficient if 
there is any possibility of duplication. Upon return, register A = 0, 
1, 2, or 3 if the operation was successful and 0FFH (255 decimal) if 
no more directory space is available. The make function has the 
side-effect of activating the FCB and thus a subsequent open is not 
necessary. 
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*************************************** 

* * 

* FUNCTION 23: RENAME FILE * 

* * 

*************************************** 

* Entry Parameters: * 

* Register C: 17H * 

* Registers DE: FCB Address * 

* * 

* Returned Value: * 

* Register A: Directory Code * 
*************************************** 



The Rename function uses the FCB addressed by DE to change all 
occurrences of the file named in the first 16 bytes to the file named 
in the second 16 bytes. The drive code "dr M at position is used to 
select the drive, while the drive code for the new file name at 
position 16 of the FCB is assumed to be zero. Upon return, register A 
is set to a value between and 3 if the rename was successful, and 
0FFH (255 decimal) if the first file name could not be found in the 
directory scan. 



*************************************** 

* * 

* FUNCTION 24: RETURN LOGIN VECTOR * 

* * 

*************************************** 

* Entry Parameters: * 

* Register C: 18H * 

* * 

*' Returned Value: * 

* Registers HL: Login Vector * 
*************************************** 

The login vector value returned by CP/M is a 16-bit value in HL, 
where the least significant bit of L corresponds to the first drive A, 
and the high order bit of H corresponds to the sixteenth drive, 
labelled P. A "0" bit indicates that the drive is not on-line, while 
a "1" bit marks an drive that is actively on-line due to an explicit 
disk drive selection, or an implicit drive select caused by a file 
operation which specified a non-zero M dr" field. Note that 
compatibility is maintained with earlier releases, since registers A 
and L contain the same values upon return. 
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*************************************** 

* * 

* FUNCTION 25: RETURN CURRENT DISK * 

* * 

*************************************** 

* Entry Parameters: * 

* Register C: 19H * 

* * 

* Returned Value: * 

* Register A: Current Disk * 
*************************** * * ********** 

Function 25 returns the currently selected default disk number 
in register A. The disk numbers range from through 15 corresponding 
to drives A through P. 



*************************************** 

* * 

* FUNCTION 26: SET DMA ADDRESS * 

* * 
*************************************** 

* Entry Parameters: * 

* Register C: 1AH * 

* Registers DE: DMA Address * 

* * 
*************************************** 

"DMA" is an acronym for Direct Memory Address, which is often 
used in connection with disk controllers which directly access the 
memory of the mainframe computer to transfer data to and from the disk 
subsystem. Although many computer systems use non-DMA access (i.e., 
the data is transferred through programmed I/O operations) , the DMA 
address has, in CP/M, come to mean the address at which the 128 byte 
data record resides before a disk write and after a disk read. Upon 
cold start, warm start, or disk system reset, the DMA address is 
automatically set to BOOT+0080H. The Set DMA function, however, can 
be used to change this default value to address another area of memory 
where the data records reside. Thus, the DMA address becomes the 
value specified by DE until it is changed by a subsequent Set DMA 
function, cold start, warm start, or disk system reset. 
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*************************************** 

* * 

* FUNCTION 27: GET ADDR (ALLOC) * 

* * 

*************************************** 

* Entry Parameters: * 

* Register C: 1BH * 

* * 

* Returned Value: * 

* Registers HL: ALLOC Address * 
*************************************** 

An "allocation vector" is maintained in main memory for each 
on-line disk drive. Various system programs use the information 
provided by the allocation vector to determine the amount of remaining 
storage (see the STAT program) . Function 27 returns the base address 
of the allocation vector for the currently selected disk drive. The 
allocation information may, however, be invalid if the selected disk 
has been marked read/only. Although this function is not normally 
used by application programs, additional details of the allocation 
vector are found in the "CP/M Alteration Guide. " 



*************************************** 

* * 

* FUNCTION 28: WRITE PROTECT DISK * 

* * 
*************************************** 

* Entry Parameters: * 

* Register C: 1CH * 

* * 

*************************************** 

The disk write protect function provides temporary write 
protection for the currently selected disk. Any attempt to write to 
the disk, before the next cold or warm start operation produces the 
me s s ag e 

Bdos Err on d: R/O 
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*************************************** 

* * 

* FUNCTION 29: GET READ/ONLY VECTOR * 

* * 

*************************************** 

* Entry Parameters: * 

* Register C: 1DH * 

* * 

* Returned Value: * 

* Registers HL: R/O Vector Value* 
*************************************** 

Function 29 returns a bit vector in register pair HL which 
indicates drives which have the temporary read/only bit set. Similar 
to function 24, the least significant bit corresponds to drive A, 
while the most significant bit corresponds to drive P. The R/O bit is 
set either by an explicit call to function 28, or by the automatic 
software mechanisms within CP/M which detect changed disks. 



*************************************** 

* * 

* FUNCTION 30: SET FILE ATTRIBUTES * 

* * 

*************************************** 

* Entry Parameters: * 

* Register C: 1EH * 

* Registers DE: FCB Address * 

* * 

* Returned Value: * 

* Register A: Directory Code * 
*************************************** 

The Set File Attributes function allows programmatic 
manipulation of permanent indicators attached to files. In 
particular, the R/O and System attributes (tl' and t2') can be set or 
reset. The DE pair addresses an unambiguous file name with the 
appropriate attributes set or reset. Function 30 searches for a 
match, and changes the matched directory entry to contain the selected 
indicators. Indicators fl 1 through f4* are not presently used, but 
may be useful for applications programs, since they are not involved 
in the matching process during file open and close operations. 
Indicators f5* through f8' and t3' are reserved for future system 
expansion. 
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*************************************** 

* * 

* FUNCTION 31: GET ADDR(DISK PARMS) * 

* * 

*************************************** 

* Entry Parameters: * 

* Register C: 1FH * 

* * 

* Returned Value: * 

* Registers HL: DPB Address * 
*************************************** 



The address of the BIOS resident disk parameter block is 
returned in HL as a result of this function call. This address can be 
used for either of two purposes. First, the disk parameter values can 
be extracted for display and space computation purposes, or transient 
programs can dynamically change the values of current disk parameters 
when the disk environment changes, if required. Normally, application 
programs will not require this facility. 



*************************************** 

* * 

* FUNCTION 32: SET/GET USER CODE * 

* * 

*************************************** 

* Entry Parameters: * 

* Register C: 20H * 

* Register E: 0FFH (get) or * 

* User Code (set) * 

* * 

* Returned Value: * 

* Register A: Current Code or * 

* (no value) * 
*************************************** 

An application program can change or interrogate the currently 
active user number by calling function 32. If register E = 0FFH, then 
the value of the current user number is returned in register A, where 
the value is in the range to 31. If register E is not 0FFH, then 
the current user number is changed to the value of E (modulo 32). 
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*************************************** 

* * 

* FUNCTION 33: READ RANDOM * 

* * 

*************************************** 

* Entry Parameters: * 

* Register C: 21H * 

* Registers DE: FCB Address * 

* * 

* Returned Value: * 

* Register A: Return Code * 
*************************************** 

The Read Random function is similar to the sequential file read 
operation of previous releases, except that the read operation takes 
place at a particular record number, selected by the 24-bit value 
constructed from the three byte field following the FCB (byte 
positions r0 at 33, rl at 34, and r2 at 35). Note that the sequence 
of 24 bits is stored with least significant byte first (r0) , middle 
byte next (rl) , and high byte last (r2) . CP/M does not reference byte 
r2, except in computing the size of a file (function 35). Byte r2 
must be zero, however, since a non-zero value indicates overflow past 
the end of file. 

Thus, the r0,rl byte pair is treated as a double-byte, or "word" 
value, which contains the record to read. This value ranges from to 
65535, providing access to any particular record of the 8 megabyte 
file. In order to process a file using random access, the base extent 
(extent 0) must first be opened. Although the base extent may or may 
not contain any allocated data, this ensures that the file is properly 
recorded in the directory, and is visible in DIR requests. The 
selected record number is then stored into the random record field 
(r0,rl), and the BDOS is called to read the record. Upon return from 
the call, register A either contains an error code, as listed below, 
or the value 00 indicating the operation was successful. In the 
latter case, the current DMA address contains the randomly accessed 
record. Note that contrary to the sequential read operation, the 
record number is not advanced. Thus, subsequent random read 
operations continue to read the same record. 

Upon each random read operation, the logical extent and current 
record values are automatically set. Thus, the file can be 
sequentially read or written, starting from the current randomly 
accessed position. Note, however, that in this case, the last 
randomly read record will be re-read as you switch from random mode to 
sequential read, and the last record will be re-written as you switch 
to a sequential write operation. You can, of course", simply advance 
the random record position following each random read or write to 
obtain the effect of a sequential I/O operation. 

Error codes returned in register A following a random read are 
listed below. 
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01 reading unwritten data 

02 (not returned in random mode) 

03 cannot close current extent 

04 seek to unwritten extent 

05 (not returned in read mode) 

06 seek past physical end of disk 

Error code 01 and 04 occur when a random read operation accesses a 
data block which has not been previously written, or an extent which 
has not been created, which are equivalent conditions. Error 3 does 
not normally occur under proper system operation, but can be cleared 
by simply re-reading, or re-opening extent zero as long as the disk is 
not physically write protected. Error code 06 occurs whenever byte r2 
is non-zero under the current 2.0 release. Normally, non-zero return 
codes can be treated as missing data, with zero return codes 
indicating operation complete. 
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*************************************** 

* * 

* FUNCTION 34: WRITE RANDOM * 

* * 

*************************************** 

* Entry Parameters: * 

* Register C: 22H * 

* Registers DE: FCB Address * 

* * 

* Returned Value: * 

* Register A: Return Code * 
*************************************** 



The Write Random operation is initiated similar to the Read 
Random call, except that data is written to the disk from the current 
DMA address. Further, if the disk extent or data block which is the 
target of the write has not yet been allocated, the allocation is 
performed before the write operation continues. As in the Read Random 
operation, the random record number is not changed as a result of the 
write. The logical extent number and current record positions of the 
file control block are set to correspond to the random record which is 
being written. Again, sequential read or write operations can 
commence following a random write, with the notation that the 
currently addressed record is either read or rewritten again as the 
sequential operation begins. You can also simply advance the random 
record position following each write to get the effect of a sequential 
write operation. Note that in particular, reading or writing the last 
record of an extent in random mode does not cause an automatic extent 
switch as it does in sequential mode. 

The error codes returned by a random write are identical to the 
random read operation with the addition of error code 05, which 
indicates that a new extent cannot be created due to directory 
overflow. 



(All Information Contained Herein is Proprietary to Digital Research.) 

27 



*************************************** 

* * 

* FUNCTION 35: COMPUTE FILE SIZE * 

* * 

*************************************** 

* Entry Parameters: * 

* Register C: 23H * 

* Registers DE: FCB Address * 

* * 

* Returned Value: * 

* Random Record Field Set * 
*************************************** 

When computing the size of a file, the DE register pair 
addresses an FCB in random mode format (bytes r0, rl, and r2 are 
present). The FCB contains an unambiguous file name which is used in 
the directory scan. Upon return, the random record bytes contain the 
"virtual" file size which is, in effect, the record address of the 
record following the end of the file. if, following a call to 
function 35, the high record byte r2 is 01, then the file contains the 
maximum record count 65536. Otherwise, bytes r0 and rl constitute a 
16-bit value (r0 is the least significant byte, as before) which is 
the file size. 

Data can be appended to the end of an existing file by simply 
calling function 35 to set the random record position to the end of 
file, then performing a sequence of random writes starting at the 
preset record address. 

The virtual size of a file corresponds to the physical size when 
the file is written sequentially. If, instead, the file was created 
in random mode and "holes" exist in the allocation, then the file may 
in fact contain fewer records than the size indicates. If, for 
example, only the last record of an eight megabyte file is written in 
random mode (i.e. , record number 65535) , then the virtual size is 
65536 records, although only one block of data is actually allocated. 



(All Information Contained Herein is Proprietary to Digital Research.) 

28 



*************************************** 

* * 

* FUNCTION 36: SET RANDOM RECORD * 

* * 
*************************************** 

* Entry Parameters: * 

* Register C: 24H * 

* Registers DE: FCB Address; * 

* * 

* Returned Value: * 

* Random Record Field Set * 
*************************************** 

The Set Random Record function causes the BDOS to automatically 
produce the random record position from a file which has been read or 
written sequentially to a particular point. The function can be 
useful in two ways. 

First, it is often necessary to initially read and scan a 
sequential file to extract the positions of various "key" fields. As 
each key is encountered, function 36 is called to compute the random 
record position for the data corresponding to this key. If the data 
unit size is 128 bytes, the resulting record position is placed into a 
table with the key for later retrieval. After scanning the entire 
file and tabularizing the keys and their record numbers, you can move 
instantly to a particular keyed record by performing a random read 
using the corresponding random record number which was saved earlier. 
The scheme is easily generalized when variable record lengths are 
involved since the program need only store the buffer-relative byte 
position along with the key and record number in order to find the 
exact starting position of the keyed data at a later time. 

A second use of function 36 occurs when switching from a 
sequential read or write over to random read or write. A file is 
sequentially accessed to a particular point in the file, function 36 
is called which sets the record number, and subsequent random read and 
write operations continue from the selected point in the file. 
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3. A SAMPLE FILE-TO-FILE COPY PROGRAM. 

The program shown below provides a relatively simple example of 
file operations. The program source file is created as COPY. ASM using 
the CP/M ED program and then assembled using ASM or MAC, resulting in 
a "HEX" file. The LOAD program is the used to produce a COPY.COM file 
which executes directly under the CCP. The program begins by setting 
the stack pointer to a local area, and then proceeds to move the 
second name from the default area at 006CH to a 33-byte file control 
block called DFCB. The DFCB is then prepared for file operations by 
clearing the current record field. At this point, the source and 
destination FCB's are ready for processing since the SFCB at 005CH is 
properly set-up by the CCP upon entry to the COPY program. That is, 
the first name is placed into the default fcb, with the proper fields 
zeroed, including the current record field at 007CH. The program 
continues by opening the source file, deleting any exising destination 
file, and then creating the destination file. If all this is 
successful, the program loops at the label COPY until each record has 
been read from the source file and placed into the destination file. 
Upon completion of the data transfer, the destination file is closed 
and the program returns to the CCP command level by jumping to BOOT. 



0000 


= 


boot 


equ 


00h 


0005 


= 


bdos 


egu 


05h 


05c 


= 


fcbl 


egu 


005ch 


05c 


= 


sfcb 


equ 


fcbl 


006c 


s 


fcb2 


equ 


006ch 


0080 


ss 


dbuff 


equ 


0080h 


0100 


— 


tpa 


equ 


0100h 


0009 


s 


printf 


equ 


9 


000f 


- 


openf 


equ 


15 


0010 


= 


closef 


equ 


16 


0013 


= 


deletef 


equ 


19 


0014 


= 


readf 


equ 


20 


0015 


3S 


writef 


equ 


21 


0016 


SS 


makef 


equ 


22 


0100 




7 


org 


tpa 


0100 


311b02 


. 


lxi 


sp, stack 








move 


second file 


0103 


0el0 




mvi 


c,16 



sample file-to-file copy program 

at the ccp level, the command 

copy a:x.y b:u. v 

copies the file named x.y from drive 
a to a file named u.v on drive b. 



system reboot 
bdos entry point 
first file name 
source fcb 
second file name 
default buffer 
beginning of tpa 

print buffer func# 
open file func# 
close file func# 

delete file func# 
sequential read 
sequential write 
make file func# 

beginning of tpa 
local stack 



half an fcb 
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0105 
0108 
010b 
010c 
010d 
010e 
010f 
0110 



116c00 

21da01 

la 

13 

77 

23 

0d 

c20b01 



mf cb: 



0113 af 

0114 32fa01 



source of move 
destination fcb 
source fcb 
ready next 
dest fcb 
ready next 
count 16. . .0 
loop 16 times 



name has been moved, zero cr 

xra a ; a = 0h 

sta dfcbcr ; current rec = 

source and destination fcb's ready 



lxi 


d,fcb2 


lxi 


h,dfcb 


ldax 


d 


inx 


d 


mov 


m,a 


inx 


h 


dcr 


c 


jnz 


mf cb 



0117 
011a 
011d 
0120 
0121 



115c00 

cd6901 

118701 

3c 

cc6101 



lxi 


d,sfcb , 


■ source file 


call 


open 


; error if 255 


lxi 


d, nof ile 


• ready message 


inr 


a ; 


255 becomes 


cz 


finis ; 


done if no file 



0124 llda01 
0127 cd7301 



source file open, prep destination 

lxi d,dfcb ; destination 

call delete ; remove if present 



012a 


llda01 


lxi 


d,dfcb 


; destination 


012d 


cd8201 


call 


make 


\ create the file 


0130 


119601 


lxi 


d ,nodir 


• ready message 


0133 


3c 


inr 


a ; 


255 becomes 


0134 


CC6101 


cz 


finis 


• done if no dir space 



source file open, dest file open 
copy until end of file on source 



0137 


115C00 


013a 


cd7801 


013d 


b7 


013e 


C25101 


0141 


llda01 


0144 


cd7d01 


0147 


lla901 


014a 


b7 


014b 


C46101 


014e 


C33701 


0151 


llda01 


0154 


cd6e01 


0157 


21bb01 


015a 


3c 


015b 


cc6101 



copy: 



eof ile 



lxi 


d,sfcb ; 


source 


call 


read ; 


read next record 


ora 


a ; 


end of file? 


jnz 


eofile ; 


skip write if so 


not end of file, 


write the record 


lxi 


d,dfcb 


• destination 


call 


write , 


• write record 


lxi 


d , space 


• ready message 


ora 


a 


• 00 if write ok 


cnz 


finis 


? end if so 


jmp 


copy 


', loop until eof 


; end 


of file, c! 


Lose destination 


lxi 


d,dfcb 


; destination 


call 


close 


■ 255 if error 


lxi 


h,wrprot 


; ready message 


inr 


a 


• 255 becomes 00 


cz 


finis 


; shouldn't happen 



copy operation complete, end 
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015e llcc01 



lxi 



d, normal; ready message 



finis: 



0161 0e09 
0163 cd0500 
0166 C30000 



0169 0e0f open: 
016b C30500 

7 

016e 0el0 close: 

0170 C30500 

• 

0173 0el3 delete: 
0175 C30500 

0178 0el4 read: 
017a C30500 

• 

017d 0el5 write: 
017f C30500 

0182 0el6 make: 
0184 C30500 



0187 6e6f20fnof ile: 
0196 6e6f209nodir: 
01a9 6f7574fspace: 
01bb 7772695wrprot: 
01cc 636f 700normal 



01da 
01fa = 

01fb 

021b 



dfcb: 
dfcbcr 



stack 



; write message given by de, reboot 
mvi c,printf 
call bdos ; write message 
jmp boot ; reboot system 

system interface subroutines 
(all return directly from bdos) 



mvi 


c,openf 


jmp 


bdos 


mvi 


c,closef 


jmp 


bdos 


mvi 


c,deletef 


jmp 


bdos 


mvi 


c, readf 


jmp 


bdos 


mvi 


c,wr itef 


jmp 


bdos 


mvi 


c,makef 


jmp 


bdos 



console messages 

db 'no source file$* 

db 'no directory space$ ' 

db 'out of data space$ ' 

db 'write protected?$ ' 

db 'copy complete$' 



data areas 
ds 33 



destination fcb 



equ 

ds 

end 



dfcb+32 ; current record 



32 



16 level stack 



Note that there are several simplificat 
program. First, there are no checks fo 
could, for example, contain ambiguous refe 
could be detected by scanning the 32 byt 
location 005CH for ASCII question marks. A 
to ensure that the file names have, in 
locations 005DH and 006DH for non-blank ASCI 
check should be made to ensure that the sour 
names are different. A speed improvement 
more data on each read operation. One could 



ions in this particular 
r invalid file names which 
rences. This situation 
e default area starting at 
check should also be made 

fact, been included (check 
I characters). Finally, a 
ce and destination file 
could be made by buffering 
for example, determine 
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the size of memory by fetching FBASE from location 0006H and use the 
entire remaining portion of memory for a data buffer. In this case, 
the programmer simply resets the DMA address to the next successive 
128 byte area before each read. Upon writing to the destination file, 
the DMA address is reset to the beginning of the buffer and 
incremented by 128 bytes to the end as each record is transferred to 
the destination file. 
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4. A SAMPLE FILE DUMP UTILITY. 



The file dump program shown below is slightly more complex than 
the simple copy program given in the previous section. The dump 
program reads an input file, specified in the CCP command line, and 
displays the content of each record in hexadecimal format at the 
console. Note that the dump program saves the CCP's stack upon entry, 
resets the stack to a local area, and restores the CCP's stack before 
returning directly to the CCP. Thus, the dump program does not 
perform and warm start at the end of processing. 



; DUMP program reads input file and displays hex data 



0100 
0005 = 

0001 = 

0002 = 
0009 = 

0b = 

000f = 

0014 = 

5c = 
0080 = 



00d = 
000a = 



005c 
005d 
0065 
0068 
6b 
007c 
7d 



0100 210000 

0103 39 

0104 221502 
0107 315702 

010a cdcl01 
010d feff 
010f c21b01 



0112 llf301 
0115 cd9c01 
0118 C35101 



bdos 
cons 
typef 
pr mtf 

brkf 

openf 

readf 

• 

fcb 
buff 



cr 
If 



fcbdn 
fcbfn 
fcbft 
fcbrl 
fcbrc 
fcbcr 
fcbln 



org 100h 

egu 05h ;dos entry point 

egu 1 ;read console 

egu 2 ; type function 

equ 9 ;buffer print entry 

equ 11 ;break key function (true if char 

equ 15 ;file open 

equ 20 ;read function 

equ 5ch ;file control block address 

equ 80h ; input disk buffer address 

non graphic characters 

equ 0dh ; carriage return 

equ 0ah ;line feed 

file control block definitions 



equ 
equ 
equ 
equ 
equ 
equ 
equ 



fcb+0 
fcb+1 
fcb+9 
fcb+1 2 
fcb+1 5 
fcb+3 2 
fcb+33 



disk name 

file name 

disk file type (3 characters) 

file's current reel number 

file's record count (0 to 128) 

current (next) record number (0 

fcb length 



set up stack 

lxi h,0 

dad sp 

entry stack pointer in hi from the ccp 

shld oldsp 

set sp to local stack area (restored at finis) 

lxi sp,stktop 

read and print successive buffers 

call setup ;set up input file 

cpi 255 ;255 if file not present 

jnz openok ;skip if open is ok 



file not there, give error message and 

lxi d,opnmsg 

call err 

jmp finis ;to return 



return 
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011b 
011d 



3e80 
321302 



openok 



0120 210000 



0123 
0124 
0127 
0128 
012b 



012c 
01 2d 
012f 



gloop: 



e5 

cda201 

el 

da5101 

47 



7d 

e60f 

C24401 



132 cd7201 



0135 cd5901 



0138 
0139 

013c 
013d 
0140 
0141 

0144 
0145 
0147 
014a 
014b 
014e 



0f 
da5101 

7c 

cd8f01 
7d 
cd8f01 

23 

3e20 

cd6501 

78 

cd8f01 

C32301 



nonum: 



finis: 



0151 
0154 
0157 



cd7201 
2al502 
f9 



0158 c9 



break: 



0159 e5d5c5 

015c 0e0b 

015e cd0500 

0161 cldlel 



;open operation ok, set buffer index to end 

mvi a,80h 

sta ibp ;set buffer pointer to 80h 

hi contains next address to print 

lxi h,0 ;start with 0000 



push 
call 
pop 

jc 
mov 



;save line position 



;recall line position 

;carry set by gnb if end file 



h 

gnb 

h 

finis 

b,a 

print hex values 
check for line fold 
mov a , 1 

ani 0fh ;check low 4 bits 
jnz nonum 
print line number 
call crlf 

check for break key 

call break 

accum lsb = 1 if character ready 

rrc ;into carry 

jc finis ;don't print any more 



mov 
call 
mov 
call 

inx 

mvi 

call 

mov 

call 

jmp 



a, h 

phex 

a,l 
phex 

h 
a,' ' 

pchar 
a, b 
phex 
gloop 



; to next line number 



end of dump, return to ccp 
(note that a jmp to 0000h reboots) 
call crlf 
lhld oldsp 
sphl 
stack pointer contains ccp's stack location 

ret ;to the ccp 



subroutines 

; check break key (actually any key will do) 

push h! push d! push b; environment saved 

mvi c,brkf 

call bdos 

pop bi pop di pop h; environment restored 
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0164 c9 



ret 



pchar 



0165 


e5d5c5 


0168 


0e02 


016a 


5f 


016b 


cd0500 


016e 


cldlel 


0171 


c9 


0172 


3e0d 


0174 


cd6501 


0177 


3e0a 


0179 


cd6501 


017c 


c9 



crlf 



;print a character 

push hi push di push b; saved 

mvi c,typef 

mov e , a 

call bdos 

pop bi pop di pop h; restored 

ret 



mvi 

call 

mvi 

call 

ret 



a, cr 
pchar 
a, If 
pchar 



pnib 



017d 


e60f 




017f 


fe0a 




0181 


d28901 




0184 


c630 


i 


0186 


c38b01 


• 


0189 


c637 


pl0 


018b 


cd6501 


prn 


018e 


c9 


phe 


018f 


f5 




0190 


0f 




0191 


0f 




0192 


0f 




0193 


0f 




0194 


cd7d01 




0197 


fl 




0198 


cd7d01 




019b 


c9 





;print nibble in reg a 

ani 0fh ;low 4 bits 

cpi 10 

jnc pl0 

less than or equal to 9 

adi '0' 

jmp prn 

greater or equal to 10 

adi 'a' - 10 

call pchar 
ret 

;print hex char in reg a 



push 


psw 


rrc 




rrc 




rrc 




rrc 




call 


pnib 


pop 


psw 


call 


pnib 


ret 





;print nibble 



019c 0e09 
019e cd0500 
01al c9 



err: ;print error message 

; d,e addresses message ending with " $ h 

mvi cprintf ;print buffer function 

call bdos 

ret 



01a2 3al302 
01a5 fe80 
01a7 c2b301 



gnb: 



;get 


next byte 


Ida 


ibp 


cpi 


80h 


jnz 


g0 


read 


another buffer 
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01aa cdce01 
01ad b7 
01ae cab301 

01bl 37 
01b2 c9 



01b3 5f 

01b4 1600 

01b6 3c 

01b7 321302 



01ba 218000 
01bd 19 

01be 7e 

01bf b7 
01c0 c9 



01cl af 
01c2 327c00 

01c5 115C00 
01c8 0e0f 
01ca cd0500 

01cd c9 



01ce e5d5c5 
01dl 115C00 
01d4 0el4 
01d6 cd0 500 
01d9 cldlel 
01dc c9 



call diskr 

ora a ;zero value if read ok 
jz g0 ;for another byte 
; end of data, return with carry set for eof 
stc 
ret 

g0 : ;read the byte at buff+reg a 

mov e,a ;ls byte of buffer index 
mvi d,0 ;double precision index to de 
inr a ; index=index+l 
sta ibp ;back to memory 

; pointer is incremented 

; save the current file address 

lxi h,buff 

dad d 
; absolute character address is in hi 

mov a , m 

; byte is in the accumulator 

ora a ;reset carry bit 

ret 

setup: ;set up file 

; open the file for input 

xra a ;zero to accum 

sta fcbcr ;clear current record 

lxi d,fcb 
mvi c,openf 
call bdos 
; 255 in accum if open error 
ret 

diskr: ;read disk file record 
push hi push dl push b 
lxi d,fcb 
mvi c, readf 
call bdos 
pop b! pop dl pop h 
ret 



; fixed message area 
01dd 46494c0signon: db 'file dump version 2.0$' 
01f3 0d0a4e0opnmsg: db cr,lf,'no input file present on disk$' 



0213 
0215 



; variable area 
ibp: ds 2 
oldsp: ds 2 



; input buffer pointer 
; entry sp value from ccp 



0217 
0257 



stktop: 



stack area 
ds 64 



end 



; reserve 32 level stack 
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5. A SAMPLE RANDOM ACCESS PROGRAM. 

This manual is concluded with a rather extensive, but complete 
example of random access operation. The program listed below performs 
the simple function of reading or writing random records upon command 
from the terminal. Given that the program has been created, 
assembled, and placed into a file labelled RAND0M.COM, the CCP level 
command: 

RANDOM X.DAT 

starts the test program. The program looks for a file by the name 
X.DAT (in this particular case) and, if found, proceeds to prompt the 
console for input. If not found, the file is created before the 
prompt is given. Each prompt takes the form 

next command? 

and is followed by operator input, terminated by a carriage return. 
The input commands take the form 

nW nR Q 

where n is an integer value in the range to 65535, and W, R, and Q 
are simple command characters corresponding to random write, random 
read, and quit processing, respectively. If the W command is issued, 
the RANDOM program issues the prompt 

type data: 

The operator then responds by typing up to 127 characters, followed by 
a carriage return. RANDOM then writes the character string into the 
X.DAT file at record n. If the R command is issued, RANDOM reads 
record number n and displays the string value at the console. If the 
Q command is issued, the X.DAT file is closed, and the program returns 
to the console command processor. In the interest of brevity, the 
only error message is 

error, try again 

The program begins with an initialization section where the 
input file is opened or created, followed by a continuous loop at the 
label "ready" where the individual commands are interpreted. The 
default file control block at 005CH and the default buffer at 0080H 
are used in all disk operations. The utility subroutines then follow, 
which contain the principal input line processor, called "readc." 
This particular program shows the elements of random access 

processing, and can be used as the basis for further program 
development. 
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. ********************** 
• * 






;* sample ra 
• * 


ndom access 






.********************** 


0100 






org 


100h 


0000 


= 


reboot 


equ 


0000h 


0005 


= 


bdos 


equ 


00 5h 


0001 


= 


coninp 


equ 


1 


0002 


= 


conout 


equ 


2 


0009 


= 


pstring 


equ 


9 


0a 


= 


r string 


equ 


10 


0c 


= 


version 


equ 


12 


000f 


= 


openf 


equ 


15 


0010 


= 


closef 


equ 


16 


0016 


= 


makef 


equ 


22 


0021 


= 


readr 


equ 


33 


0022 


= 


writer 


equ 


34 


5c 


ss 


fcb 


equ 


005ch 


007d 


= 


ranrec 


equ 


fcb+33 


007f 


=s 


ranovf 


equ 


fcb+35 


0080 


= 


buff 


equ 


0080h 


0d 


= 


cr 


equ 


0dh 


00a 


= 


If 


equ 


0ah 



***************************** 

* 
* 
* 

***************************** 



program for cp/m 2.0 

************ 
;base of tpa 



0100 31bc0 



0103 0e0c 
0105 cd050 
0108 fe20 
010a d2160 

010d lllb0 
0110 cdda0 
0113 C3000 



0116 0e0f 
0118 115c0 
011b cd050 
011e 3c 
011f C2370 



;system reboot 
;bdos entry point 

console input function 
console output function 
print string until *$' 
read console buffer 
return version number 
file open function 
close function 
make file function 
read random 
write random 

;default file control block 
;random record position 
;high order (overflow) byte 
;buffer address 

;carriage return 
;line feed 



*************************************************** 

* * 

* load SP, set-up file for random access * 

* * 
*************************************************** 

lxi 



sp, stack 



version 2.0? 

mvi c, version 

call bdos 

cpi 20h ;version 2.0 or better? 

jnc versok 

bad version, message and go back 

lxi d,badver 

call print 

jmp reboot 



versok 



correct version for random access 

mvi 

lxi 

call 

inr 

jnz 



c, openf ;open default fcb 

d,fcb 

bdos 

a 

ready 



;err 255 becomes zero 



cannot open file, so create it 
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0122 0el6 


mvi 


c,makef 




0124 115c0 


lxi 


d,fcb 




0127 cd050 


call 


bdos 




012a 3c 


inr 


a 


;err 255 becomes zero 


012b C2370 


jnz 


ready 





012e 113a0 
0131 cdda0 
0134 C3000 



cannot create file, directory full 

lxi d,nospace 

call print 

jmp reboot ;back to ccp 

*************************************************** 

* * 

* loop back to "ready" after each command * 

* * 

*************************************************** 



ready 



0137 cde50 
013a 227d0 
013d 217f0 
0140 3600 
0142 fe51 
0144 C2560 



0147 0el0 

0149 115c0 
014c cd050 
014f 3c 

0150 cab90 
0153 c3000 



file is ready for processing 

call readcom ;read next command 

shld ranrec ;store input record# 

lxi h,ranovf 

mvi m,0 ;clear high byte if set 

cpi 'Q' ;quit? 

jnz notq 

quit processing, close file 



mvi 
lxi 
call 
inr 

jz 
jmp 



c,closef 

d,fcb 

bdos 

a 

error 

reboot 



;err 2 55 becomes 
;error message, retry 
;back to ccp 



0156 fe57 
0158 C2890 



015b 114d0 
015e cdda0 
0161 0e7f 
0163 21800 

0166 c5 

0167 e5 

0168 cdc20 
016b el 



*************************************************** 

* * 

* end of quit command, process write * 

* * 
*************************************************** 

notq: 

; not the quit command, random write? 

cpi 'W 

jnz notw 



this is a random write, fill buffer until cr 

lxi d,datmsg 

call print ;data prompt 

mvi c,127 ;up to 127 characters 

lxi h,buff ;destination 

;read next character to buff 

push b ;save counter 

push h ;next destination 

call getchr ;character to a 

pop h ;restore counter 



r loop: 
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016c 
016d 
016f 

0172 
0173 
0174 
0175 



cl 

fe0d 

ca780 

77 
23 
0d 
C2660 



erloop: 



0178 3600 



017a 


0e22 


017c 


115c0 


017f 


cd050 


0182 


b7 


0183 


c2b90 


0186 


C3370 



pop b ; restore next to fill 

cpi cr ;end of line? 

jz erloop 

not end, store character 

mov m,a 

inx h ;next to fill 

dcr c ;counter goes down 

jnz rloop ;end of buffer? 

end of read loop, store 00 
mvi 111,0 

write the record to selected record number 

mvi c, writer 

lxi d,fcb 

call bdos 

ora a ;error code zero? 

jnz error ;message if not 

jmp ready ;for another record 

*************************************************** 

* * 

* end of write command, process read * 

* * 

*************************************************** 
notw: 
; not a write command, read record? 



0189 


fe52 


cpi 


•R' 




018b 


c2b90 


jnz 


error ; 


skip if not 




• 


read 


random record 


018e 


0e21 


mvi 


c , r e ad r 




0190 


115c0 


lxi 


d,fcb 




0193 


cd050 


call 


bdos 




0196 


b7 


ora 


a j 


return code 00? 


0197 


c2b90 


jnz 


error 






• 


read 


was successful, write to console 


019a 


cdcf0 


call 


crlf ; 


new line 


019d 


0e80 


mvi 


c,128 ; 


max 128 characters 


019f 


21800 

wloop: 


lxi 


h,buff ; 


•next to get 


01a2 


7e 


mov 


a,m ; 


•next character 


01a3 


23 


inx 


h ; 


•next to get 


01a 4 


e67f 


ani 


7fh ; 


•mask parity 


01a 6 


ca370 


jz 


ready j 


for another command if 00 


01a9 


c5 


push 


b 


•save counter 


01aa 


e5 


push 


h j 


save next to get 


01ab 


fe20 


cpi 


i i 


•graphic? 


01ad 


d4c80 


cnc 


putchr 


?skip output if not 


01b0 


el 


pop 


h 




01bl 


cl 


pop 


b 




01b2 


0d 


dcr 


c ; 


•count=count-l 


01b3 


c2a20 


jnz 


wloop 




01b6 


C3370 


jmp 


ready 
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*************************************************** 

* * 



* end of read command, all errors end-up here 
* 



*************************************************** 





error: 






01b9 


11590 


lxi 


d,er rmsg 


01bc 


cdda0 


call 


print 


01bf 


C3370 


jmp 


ready 



*************************************************** 

* * 

* utility subroutines for console i/o * 

* * 
*************************************************** 



getchr: 



01c2 0e01 
01c4 cd050 
01c7 c9 



01c8 0e02 

01ca 5f 

01cb cd050 

01ce c9 



01cf 3e0d 

01dl cdc80 

01d4 3e0a 

01d6 cdc80 

01d9 c9 



putchr : 



crlf : 



;read next console character to a 

mvi c,coninp 

call bdos 
ret 



;write character from a to console 

mvi c,conout 

mov e,a ;character to send 

call bdos ;send character 

ret 



;send carriage return line feed 

mvi a,cr ;carriage return 

call putchr 

mvi a, If ;line feed 

call putchr 

ret 



print: 



01da d5 
01db cdcf0 
01de dl 
01df 0e09 
01el cd050 
01e4 c9 



01e5 116b0 
01e8 cdda0 
01eb 0e0a 
01ed 117a0 
01f0 cd050 



;print the buffer addressed by de until $ 

push d 

call crlf 

pop d ;new line 

mvi c,pstring 

call bdos ;print the string 

ret 



read com: 



;read the next command line to the conbuf 

lxi d, prompt 

call print ;command? 

mvi c,r string 

lxi d, conbuf 

call bdos ;read command line 

command line is present, scan it 
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01f3 
01f6 
01f9 
01fa 
01fb 
01fc 

01fd 
01ff 
0201 

0204 

0205 
0206 
0207 
0208 
0209 
20a 
020b 
020c 
020f 
0210 



0213 
0215 
0217 

0218 
21a 



21000 

117C0 

la 

13 

b7 

c8 

d630 
fe0a 
d2130 

29 

4d 

44 

29 

29 

09 

85 

6f 

d2f90 

24 

C3f90 



C630 
fe61 
d8 

e65f 
c9 



lxi 
lxi 
reader ldax 
inx 



endrd: 



h,0 ;start with 0000 

d ,00111 in; command line 

d ;next command character 

d ; to next command position 

a jcannot be end of command 



ora 

rz 

not zero, numeric? 

sui '0' 

cpi 10 rcarry if numeric 

jnc endrd 

add-in next digit 

dad h ;*2 

c,l 

;bc = value * 2 

;*4 

;*8 

;*2 + *8 = *10 

;+digit 



mov 
mov 
dad 
dad 
dad 
add 
mov 
jnc 
inr 
jmp 



b,h 

h 

h 

b 

1 

l,a 

readc 

h 

readc 



;for another char 

; over flow 

;for another char 



021b 
23a 
024d 
0259 
026b 



end of read, restore value in a 

adi '0' ; command 

cpi 'a' ;translate case? 

re 

lower case, mask lower case bits 

ani 101$llllb 

ret 

*************************************************** 

* * 

* string data area for console messages * 

* * 

*************************************************** 

badver : 

'sorry, you need cp/m version 2$' 



536f79 db 

nospace: 
4e6f29 db 

datmsg : 
547970 db 

errmsg : 
457272 db 

prompt: 
4e6570 db 



'no directory space$ ' 
'type data: $' 
'error, try again. $' 
'next command? $' 
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027a 


21 


conbuf : 


db 


027b 




consiz: 


ds 


027c 




conlin: 


ds 


0021 


= 


conlen 


equ 


029c 




stack: 


ds 


2bc 






end 



*************************************************** 

* * 

* fixed and variable data area * 

* * 

*************************************************** 

conlen ;length of console buffer 
1 ;resulting size after read 
32 ; length 32 buffer 
$-consiz 



32 



;16 level stack 



Again, major improvements could be made to this particular 
program to enhance its operation. In fact, with some work, this 
program could evolve into a simple data base management system. One 
could, for example, assume a standard record size of 128 bytes, 
consisting of arbitrary fields within the record. A program, called 
GETKEY, could be developed which first reads a sequential file and 
extracts a specific field defined by the operator. For example, the 
command 

GETKEY NAMES.DAT LASTNAME 10 20 



would cause GETKEY to read the data base file 
the "LASTNAME" field from each record, sta 
ending at character 20. GETKEY builds a table 
each particular LASTNAME field, along with its 
location within the file. The GETKEY progr 
and writes a new file, called LASTNAME. KEY, wh 
list of LASTNAME fields with their corre 
(This list is called an "inverted index" in 

parlance. ) 



NAMES.DAT and extract 

rting at position 10 and 

in memory consisting of 

16-bit record number 

am then sorts this list, 

ich is an alphabetical 

sponding record numbers. 

information retrieval 



Rename the program shown above as QUERY, and massage it a bit so 
that it reads a sorted key file into memory. The command line might 
appear as: 

QUERY NAMES.DAT LASTNAME. KEY 

Instead of reading a number, the QUERY program reads an alphanumeric 
string which is a particular key to find in the NAMES.DAT data base. 
Since the LASTNAME. KEY list is sorted, you can find a particular entry 
quite rapidly by performing a "binary search," similar to looking up a 
name in the telephone book. That is, starting at both ends of the 
list, you examine the entry halfway in between and, if not matched, 
split either the upper half or the lower half for the next search. 
You'll quickly reach the item you're looking for (in log2(n) steps) 
where you'll find the corresponding record number. Fetch and display 
this record at the console, just as we have done in the program shown 
above. 
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At this point you're just getting started. With a little more 
work, you can allow a fixed grouping size which differs from the 128 
byte record shown above. This is accomplished by keeping track of the 
record number as well as the byte offset within the record. Knowing 
the group size, you randomly access the record containing the proper 
group, offset to the beginning of the group within the record read 
sequentially until the group size has been exhausted. 

Finally, you can improve QUERY considerably by allowing boolean 
expressions which compute the set of records which satisfy several 
relationships, such as a LASTNAME between HARDY and LAUREL, and an AGE 
less than 45. Display all the records which fit this description. 
Finally, if your lists are getting too big to fit into memory, 
randomly access your key files from the disk as well. One note of 
consolation after all this work: if you make it through the project, 
you'll have no more need for this manual! 
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SYSTEM FUNCTION SUMMARY. 



FUNC FUNCTION NAME 



INPUT PARAMETERS OUTPUT RESULTS 



System Reset 

1 Console Input 

2 Console Output 

3 Reader Input 

4 Punch Output 

5 List Output 

6 Direct Console I/O 

7 Get I/O Byte 

8 Set I/O Byte 

9 Print String 

10 Read Console Buffer 

11 Get Console Status 

12 Return Version Number 

13 Reset Disk System 

14 Select Disk 

15 Open File 

16 Close File 

17 Search for First 

18 Search for Next 

19 Delete File 

20 Read Sequential 

21 Write Sequential 

22 Make File 

23 Rename File 

24 Return Login Vector 

25 Return Current Disk 

26 Set DMA Address 

27 Get Addr (Alloc) 

28 Write Protect Disk 

29 Get R/O Vector 

30 Set File Attributes 

31 Get Addr(disk parms) 

32 Set/Get User Code 
3 3 Read Random 

34 Write Random 

35 Compute File Size 

36 Set Random Record 



none 




none 




none 




A = 


char 


E = c 


har 


none 




none 




A = 


char 




E = c 


har 


none 




E = c 


har 


none 




see d 


ef 


see 


def 




none 




A = 


IOBYTE 


E = IOBYTE 


none 




DE = 


.Buffer 


none 




DE = 


.Buffer 


see 


def 




none 




A = 


00/FF 


none 




HL= 


Version* 


none 




see 


def 




E = Disk Number 


see 


def 




DE = 


.FCB 


A = 


Dir 


Code 


DE » 


.FCB 


A = 


Dir 


Code 


DE = 


.FCB 


A = 


Dir 


Code 


none 




A = 


Dir 


Code 


DE = 


.FCB 


A = 


Dir 


Code 


DE = 


.FCB 


A = 


Err 


Code 


DE = 


.FCB 


A = 


Err 


Code 


DE = 


.FCB 


A = 


Dir 


Code 


DE = 


.FCB 


A = 


Dir 


Code 


none 




HL= 


Login Vect* 


none 




A = 


Cur 


Disk# 


DE = 


.DMA 


none 




none 




HL= 


.Alloc 


none 




see 


def 




none 




HL= 


R/O 


Vect* 


DE = 


.FCB 


see 


def 




none 




HL= 


.DPB 


see 6 


lef 


see 


def 




DE = 


.FCB 


A = 


Err 


Code 


DE = 


.FCB 


A = 


Err 


Code 


DE = 


.FCB 


r0, 


rl , 


r2 


DE = 


.FCB 


r0, 


rl. 


r2 



Note that A = L, and B = H upon return 
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1. INTRODUCTION 

The standard CP/M system assumes operation on an Intel MDS-800 
microcomputer development system, but is designed so that the user can 
alter a specific set of subroutines which define the hardware 
operating environment. In this way, the user can produce a diskette 
which operates with any IBM-3741 format compatible drive controller 
and other peripheral devices. 

Altnough standard CP/M 2.0 is configured for single density floppy 
disks, field-alteration features allow adaptation to a wide variety of 
disk subsystems from single drive minidisks through high-capacity 
"hard disk" systems. In order to simplify the following adaptation 
process, we assume that CP/M 2.0 will first be configured for single 
density floppy disks where minimal editing and debugging tools are 
available. If an earlier version of CP/M is available, the 
customizing process is eased considerably. In this latter case, you 
may. wisn to briefly review the system generation process, and skip to 
later sections which discuss system alteration for non-standard disk 
systems. 

In order to achieve device independence, CP/M is separated into 
tnree distinct modules: 

3I0S - basic I/O system which is environment dependent 
BOOS - basic disk operating system which is not dependent 

upon the hardware configuration 
CCP - the console command processor which uses the BDOS 

Of these modules, only the BIOS is dependent upon the particular 
Hardware. That is, the user can "patch" the distribution version of 
CP/M to provide a new BIOS which provides a customized interface 
between the remaining CP/M modules and the user's own hardware system. 
The purpose of this document is to provide a step-by-step procedure 
for patching your new BIOS into CP/M. 

If CP/M is being tailored to your computer system for the first 
time, the new BIOS requires some relatively simple software 
development and testing. The standard BIOS is listed in Appendix B, 
and can be used as a model for the customized package. A skeletal 
version of the BIOS is given in Appendix C which can serve as the 
basis for a modified BIOS. In addition to the BIOS, the user must 
write a simple memory loader, called GETSYS, which brings the 
operating system into memory. In order to paten the new BIOS into 
CP/M, the user must write tne reverse of GETSYS, called PUTSYS, which 
places an altered version of CP/M back onto the diskette. PUTSYS can 
be derived from GETSYS by changing the disk read commands into disk 
write commands. Sample skeletal GETSYS and PUTSYS programs are 
described in Section 3, and listed in Appendix D. In order to make 
the CP/M system work automatically, the user must also supply a cold 
start loader, similar to the one provided with CP/M (listed in 
Appendices A and B) . A skeletal form of a cold start loader is given 
in Appendix E which can serve as a model for your loader. 
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2. FIRST LEVEL SYSTEM REGENERATION 

The procedure to follow to paten the CP/M system is given below in 
several steps. Address references in each step are shown with a 
following "H" which denotes the hexadecimal radix, and are given for a 
20K CP/M system. For larger CP/M systems, add a "bias" to each 
address whicn is shown with a "+b" following it, where b is equal to 
tne memory size - 20K. Values for b in various standard memory sizes 
are 



24K 


b 


= 


24K 


- 


20K 


= 


4K 


= 


1000H 


32K 


b 


= 


32K 


- 


20K 


= 


12K 


= 


3000H 


40K 


b 


= 


40K 


- 


20K 


= 


20K 


= 


5000H 


4 8K 


: b 


= 


48K 


- 


20K 


= 


28K 


= 


7000H 


5 6K 


: b 


= 


5 6K 


- 


20K 


= 


36K 


= 


9000H 


62K 


b 


= 


62K 


- 


20K 


= 


42K 


= 


A800H 


64K 


b 


= 


64K 


- 


20K 


= 


44K 


= 


8000H 



Note: The standard distribution version of CP/M is set for 
operation within a 20K memory system. Therefore, you must first bring 
up the 20K CP/M system, and then configure it for your actual memory 
size (see Second Level System Generation) . 

(1) Review Section 4 and write a GETSYS program which reads the 
first two tracks of a diskette into memory. The data from the diskette 
must begin at location 3380H. Code GETSYS so that it starts at 
location 100ri (oase of the TPA) , as shown in the first part of 
Appendix d. 

(2) Test tne GETSYS program by reading a blank diskette into 
memory, and check to see that the data has been read properly, and 
that the diskette has not been altered in any way by the GETSYS 
program. 

(3) Run the GETSYS program using an initialized CP/M diskette to 
see if GETSYS loads CP/M starting at 3380H (the operating system 
actually starts 128 bytes later at 3400H) . 

(4) Review Section 4 and write the PUTSYS program which writes 
memory starting at 3380ri back onto the first two tracks of the 
diskette. The PUTSYS program should be located at 200H, as shown in 
the second part of Appendix D. 

(5) Test the PUTSYS program using a blank uninitialized diskette 
by writing a portion of memory to the first two tracks; clear memory 
and read it back using GETSYS. Test PUTSYS completely, since this 
program will be used to alter CP/M on disk. 



(6) Study Sections 5, 6, and 7, along with the distribution 
version of the BIOS given in Appendix B, and write a simple version 
which performs a similar function for the customized environment. Use 
the program given in Appendix C as a model. Call this new BIOS by the 
name CBIOS (customized BIOS). Implement only the primitive disk 
operations on a single drive, and simple console 
functions in this phase. 



input/output 
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(7) Test CBIOS completely to ensure that it properly performs 
console character I/O and disk reads and writes. Be especially 
careful to ensure that no disk write operations occur accidently 
during read operations, and check that the proper track and sectors 
are addressed on all reads and writes. Failure to make these checks 
may cause destruction of the initialized CP/M system after it is 
patched. 

(8) Referring to Figure 1 in Section 5, note that the 3I0S is 
placed between locations 4A00H and 4FFFH. Read the CP/M system using 
GETSYS and replace the BIOS segment by the new CBIOS developed in step 
(6) and tested in step (7) . This replacement is done in the memory of 
the machine, and will be placed on the diskette in the next step. 

(9) Use PUTSYS to place the patched memory image of CP/M onto the 
first two tracks of a blank diskette for testing. 

(10) Use GETSYS to bring the copied memory image from the test 
diskette back into memory at 3380H, and check to ensure that it has 
loaded back properly (clear memory, if possible, before the load). 
Upon successful load, brancn to the cold start code at location 4A00H. 
The cold start routine will initialize page zero, then jumo to the CCP 
at location 3400H which will call the BDOS, which will call the CBIOS. 
The CBIOS will be asked by the CCP to read sixteen sectors on track 2, 
and if successful, CP/M will type "A>", the system prompt. 

When you make it this far, you are almost on the air. If you have 
trouble, use whatever debug facilities you have available to trace and 
breakpoint your CBIOS. 

(11) Upon completion of step (10) , CP/M has prompted the console 
for a command input. Test the disk write operation by typing 

SAVE 1 X.COM 
(recall that all commands must be followed by a carriage return). 
CP/M should respond with another prompt (after several disk accesses) : 

A> 
If it does not, deoug your disk write functions and retry. 

(12) Then test the directory command by typing 
DIR 

CP/M should respond with 
A: X COM 

(13) Test the erase command by typing 
ERA X.COM 
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CP/M should respond with the A prompt. When you make it this far, you 
should have an operational system which will only require a bootstrap 
loader to function completely. 

(14) Write a bootstrap loader which is similar to GETSYS, and 
place it on track 0, sector 1 using PUTSYS (again using the test 
diskette, not the distribution diskette) . See Sections 5 and 8 for 
more information on the bootstrap operation. 

(15) Retest the new test diskette with the bootstrap loader 
installed by executing steps (11), (12), and (13). Upon completion of 
these tests, type a control-C (control and C keys simultaneously) . The 
system should then execute a "warm start" which reboots the system, 
and types the A prompt. 

(16) At this point, you probably have a good version of your 
customized CP/M system on your test diskette. Use GETSYS to load CP/M 
from your test diskette. Remove the test diskette, place the 
distribution diskette (or a legal copy) into the drive, and use PUTSYS 
to replace the distribution version by your customized version. Do 
not make this replacement if you are unsure of your patch since this 
step destroys the system which was sent to you from Digital Research. 

(17) Load your modified CP/M system and test it by typing 

DIR 

CP/M should respond with a list of files which are provided on the 
initialized diskette. One such file should be the memory image for 
the debugger, called DDT.COM. 

cJOTE: from now on, it is important that you always reboot tne CP/M 
system (ctl-C is sufficient) when the diskette is removed and replaced 
by anotner diskette, unless the new diskette is to be read only. 

(18) Load and test the debugger by typing 

DDT 

(see the document "CP/M Dynamic Debugging Tool (DDT)" for operating 
procedures. You should take tne time to become familiar with DDT, it 
will be your oest friend in later steps. 

(19) Before making further CBIOS modifications, practice using 
the editor (see the ED user's guide), and assembler (see the ASM 
user's guide). Then recode and test the GETSYS, PUTSYS, and CBIOS 
programs using ED, ASM, and DDT. Code and test a COPY program which 
does a sector-to-sector copy from one diskette to another to obtain 
oack-up copies of the original diskette (NOTE: read your CP/M 
Licensing Agreement; it specifies your legal responsibilities when 
copying the CP/M system) . Place the copyright notice 



Copyright (c) , 1979 
Digital Research 
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on each copy which is made with your COPY program. 

(20) Modify your CBIOS to include the extra functions for 
punches, readers, signon messages, and so-forth, and add the 
facilities for a additional disk drives, if desired. You can make 
these changes with the GETSYS and PUTSYS programs which you have 
developed, or you can refer to the following section, which outlines 
CP/M facilities which will aid you in the regeneration process. 

You now have a good copy of the customized CP/M system. Note that 
although the CBIOS portion of CP/M which you have developed belongs to 
you, the modified version of CP/M which you have created can be copied 
for your use only (again, read your Licensing Agreement) , and cannot 
be legally copied for anyone else's use. 

It should be noted that your system remains file-compatible with all 
other CP/M systems, (assuming media compatiblity , of course) which 
allows transfer of non-proprietary software between users of CP/M. 
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3. SECOND LEVEL SYSTEM GENERATION 

Now that y ou have the CP/M system running, you will want to 
configure CP/M for your memory size. In general, you will first get a 
memory image of CP/M with the "MOVCPM" program (system relocator) and 
place this memory image into a named disk file. The disk file can then 
be loaded, examined, patched, and replaced using the debugger, and 
system generation program. For further details on the operation of 
these programs, see the "Guide to CP/M Features and Facilities" 
manual. 

Your CBIOS and BOOT can be modified using ED, and assembled using 
ASM, producing files called CBIOS. HEX and BOOT. HEX, which contain the 
machine code for CBIOS and BOOT in Intel hex format. 

To get the memory image of CP/M into the TPA configured for the 
desired memory size, give the command: 

MOVCPM xx * 

where "xx" is the memory size in decimal K bytes (e.g., 32 for 32K) . 
The response will oe: 

CONSTRUCTING xxK CP/M VERS 2.0 
READY FOR "SYSGEN" OR 
"SAVE 3 4 CPMxx.COM" 

At this ooint, an image of a CP/M in the TPA configured for the 
requested memory size. The memory image is at location 0900H through 
227FH. (i.e., The BOOT is at 0900H, the CCP is at 980H, the BDOS 
starts at 1180H, and the BIOS is at 1F80H.) Note that the memory 
image has the standard MDS-800 BIOS and BOOT on it. It is now 
necessary to save the memory image in a file so that you can patch 
your CBIOS and C300T into it: 

SAVE 34 CPMxx.COM 

The memory image created by the "MOVCPM" program is offset by a 
negative bias so that it loads into the free area of the TPA, and thus 
does not interfere with the operation of CP/M in higher memory. This 
memory image can oe subsequently loaded under DDT and examined or 
changed in preparation for a new generation of the system. DDT is 
loaded with the memory image by typing: 

DDT CPMxx.COM Load DDT, then read the CPM 

image 

DDT should respond with 

NEXT PC 
2300 0100 

(The DDT prompt) 

You can then use the display and disassembly commands to examine 
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portions of the memory image between 900H and 227FH. Note, however, 
that to find any particular address within the memory image, you must 
apply the negative bias to the CP/M address to find the actual 
address. Track 00, sector 01 is loaded to location 900H (you should 
find the cold start loader at 900H to 97FH) , track 00, sector 02 is 
loaded into 980H (this is the base of the CCP) , and so-forth through 
the entire CP/M system load. In a 20K system, for example, the CCP 
resides at the CP/M address 3400H, but is placed into memory at 980H 
by the SYSGEN program. Thus, the negative bias, denoted by n, 
satisfies 

3400H + n = 980H, or n = 980H - 3400H 

Assuming two's comolement arithmetic, n = D580H, which can be checked 
by 

3400H + D580H = 10980H = 0980H (ignoring nigh-order 

overflow) . 

iSlote that for larger systems, n satisfies 

(3400H+b) + n = 980H, or 
n = 980H - (3400H + b) , or 
n = D5 8 0H - b. 

The value of n for common CP/M systems is given below 

memory size bias b negative offset n 

2 0K 00H D5 8 0H - 00H = D5 8 0H 

24K 1000H D580H - 1000H = C580H 

32K 3000H D580H - 3000H = A580H 

40K 5000H D580H - 5000H = 8580H 

48K 7000H D580H - 7000H = 6580H 

56K 9000H D580H - 9000H = 4580H 

62K A800H D580H - A800H = 2.D80H 

64K B000H D580H - B000H = 2580K 

Assume, for example, that you want to locate the address x within the 
memory image loaded under DDT in a 20K system. First type 

Hx,n Hexadecimal sum and difference 

and DDT will respond with the value of x+n (sum) and x-n (difference). 
The first number printed by DDT will be the actual memory address in 
the image where the data or code will be found. The input 

H3400,D580 

for example, will produce 980H as the sum, which is where the CCP is 
located in the memory image under DDT. 

Use the L command to disassemble portions the BIOS located at 
(4A00H+D)-n which, when you use the H command, oroduces an actual 
address of 1F80H. The disassembly command would thus be 
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L1F80 

It is now necessary to catch in your CBOOT and CBIOS routines. The 
BOOT resides at location 0900H in the memory image. If the actual 
load address is "n", then to calculate the bias (m) use the command: 

H900,n Subtract load address from 

target address. 

The second number typed in response to the command is the desired bias 
(m) . For example, if your BOOT executes at 0080H, tne command: 

H900,80 

will reply 

0980 0880 Sum and difference in hex. 

Therefore, the bias "m" would be 0880H. To read-in the BOOT, give the 
command: 



ICBOOT.HEX Input file CBOOT. HEX 



Then: 



Rm Read CBOOT with a bias of 

m (=900H-n) 

You may now examine your CBOOT with: 

L900 

We are now ready to replace tne CBIOS. Examine the area at 1F80H 
where the original version of the CBIOS resides. Then type 

ICBIOS.HEX Ready the "hex" file for loading 

assume that your CBIOS is being integrated into a 20K CP/M system, and 
thus is origined at location 4A00H. In order to properly locate the 
CBIOS in the memory image under DDT, we must apply the negative bias n 
for a 20K system when loading the hex file. This is accomplished oy 
typing 

RD580 Read the file with bias D580H 

Upon completion of the read, re-examine the area where the CBIOS has 
been loaded (use an "L1F80" command) , to ensure that is was loaded 
properly. When you are satisfied that the change has been made, 
return from DDT using a control-C or "G0" command. 

Now use SYSGEN to replace the patched memory image back onto a 
diskette (use a test diskette until you are sure of your patch) , as 
shown in the following interaction 
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SYSGEN Start the SYSGEN program 

SYSGEN VERSION 2.0 Sign-on message from SYSGEN 

SOURCE DRIVE NAME (OR RETURN TO SKIP) 

Respond with a carriage return 
to skip the CP/M read operation 
since the system is already in 
memory. 

DESTINATION DRIVE NAME (OR RETURN TO REBOOT) 

Respond with "3" to write the 
new system to the diskette in 
drive B. 

DESTINATION ON B r THEN TYPE RETURN 

Place a scratch diskette in 
drive B r then type return. 



FUNCTION COMPLETE 
DESTINATION DRIVE 



NAME (OR RETURN TO REBOOT) 



Place the scratch diskette in your drive A, and then perform a 
coldstart to bring up the new CP/M system you have configured. 

Test the new CP/M system, and place the Digital Research copyright 
notice on the diskette, as specified in your Licensing Agreement: 

Copyright (c) , 1979 
Digital Research 



4. SAMPLE GETSYS AND PUTSYS PROGRAMS 

The following program provides a framework for the GETSYS and 
PUTSYS programs referenced in Section 2. The READS EC and WRITESEC 
subroutines must be inserted by the user to read and write the 
specific sectors. 

GETSYS PROGRAM - READ TRACKS AND 1 TO MEMORY AT 3 380H 

USE 
(SCRATCH REGISTER) 
TRACK COUNT (0 r 1) 
SECTOR COUNT (1,2,... ,26) 
(SCRATCH REGISTER PAIR) 
LOAD ADDRESS 
SET TO STACK ADDRESS 

SET STACK POINTER TO SCRATCH AREA 

SET BASE LOAD ADDRESS 

START WITH TRACK 

READ NEXT TRACK (INITIALLY 0) 

READ STARTING WITH SECTOR 1 

READ NEXT SECTOR 

USER-SUPPLIED SUBROUTINE 

MOVE LOAD ADDRESS TO NEXT 1/2 PAGE 

HL = HL + 128 

SECTOR = SECTOR + 1 

CHECK FOR END OF TRACK 

CARRY GENERATED IF SECTOR < 27 

; ARRIVE HERE AT END OF TRACK, MOVE TO NEXT TRACK 
INR B 

MOV A,B ;TEST FOR LAST TRACK 

CPI 2 
JC RDTRK ; CARRY GENERATED IF TRACK < 2 

; ARRIVE HERE AT END OF LOAD, HALT FOR NOW 
HLT 

9 

; USER-SUPPLIED SUBROUTINE TO READ THE DISK 
READSEC: 

ENTER WITH TRACK NUMBER IN REGISTER B, 
SECTOR NUMBER IN REGISTER C, AND 
ADDRESS TO FILL IN HL 



; GE' 


rSYS PI 


^OGRAM - 


REGISTER 






A 






B 






C 






DE 






HL 






SP 




START: 


LXI 


SP,3380H 




LXI 


H r 3380H 




MVI 


B, 


RDTRK: 








MVI 


C,l 


RDSEC: 








CALL 


READSEC 




LXI 


D,128 




DAD 


D 




INR 


C 




MOV 


A,C 




CPI 


27 




JC 


RDSEC 



PUSH 
PUSH 



;SAVE B AND C REGISTERS 
;SAVE HL REGISTERS 



perform disk read at this point, branch to 
label START if an error occurs 



POP 


H 


POP 


B 


RET 





? RECOVER HL 

? RECOVER B AND C REGISTERS 

;BACK TO MAIN PROGRAM 

END START 
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Mote that this program is assembled and listed in Appendix C for 
reference purposes, with an assumed origin of 100H. The hexadecimal 
operation codes which are listed on the left may be useful if the 
program has to be entered through y° ur machine's front panel switcnes. 

The PUTSYS program can be constructed from GETSYS by changing only 
a few operations in the GETSYS program given above, as shown in 
Appendix D. The register pair HL become the dump address (next 
address to write) f and operations upon these registers do not change 
within the program. The READSEC subroutine is replaced by a WRITESEC 
subroutine which performs the opposite function: data from address HL 
is written to the track given by register B and sector given oy 
register C. It is often useful to combine GETSYS and PUTSYS into a 
single program during the test and development phase, as shown in the 
Appendix. 
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5. DISKETTE ORGANIZATION 

The sector allocation for the standard distribution version of 
CP/M is given here for reference purposes. The first sector (see 
table on the following page) contains an optional software boot 
section. Disk controllers are often set up to bring track 0, sector 1 
into memory at a specific location (often location O000H) . The 
program in this sector, called BOOT, has the responsibility of 
bringing the remaining sectors into memory starting at location 
3400tf+b. If your controller does not have a built-in sector load, you 
can ignore the program in track 0, sector 1, and begin the load from 
track sector 2 to location 3400H+b. 

As an example, the Intel MDS-800 hardware cold start loader brings 
track 0, sector 1 into absolute address 3000H. Upon loading this 
sector, control transfers to location 3000H, where the bootstrap 
operation commences by loading the remainder of tracks 0, and all of 
track 1 into memory, starting at 3400H+b. The user should note that 
this bootstrap loader is of little use in a non-MDS environment, 
althougn it is useful to examine it since some of the boot actions 
will have to be duplicated in your cold start loader. 
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Track# Sector# 
00 01 



Paget 



Memory Address 
(boot address) 



CP/M Module name 
Cold Start Loader 



00 



00 



02 
03 
04 
05 
06 
07 
08 
09 
10 
11 
12 
13 
14 
15 
16 
17 



00 
■a 

01 
it 

02 
•I 

03 

04 
•i 

05 

ii 

06 
ii 

07 



3400H+D 
3430H+D 
3500H+D 
3580H+D 
3600H+D 
3680H+D 
3700H+D 
3780H+D 
3800H+D 
3880H+D 
3900H+D 
3980H+D 
3A00H+D 
3A80H+b 
3B00H+b 
3B80H+b 



CCP 



CCP 



00 


18 


08 


3C00H+b 


BDOS 




19 


•4 


3C80H+b 


■■ 




20 


09 


3D00H+b 


" 




21 


•• 


3D80H+D 


" 




22 


10 


3E00H+b 


■■ 




23 


ii 


3E30H+b 


•• 




24 


11 


3F00H+b 


•I 




25 


ii 


3F80H+b 


ii 




26 


12 


4000H+D 


!• 


01 


01 


•• 


4080H+b 


ii 




02 


13 


4100H+b 


•i 




03 


•• 


4180H+b 


<• 




04 


14 


4200H+b 


■I 




05 


•• 


4280H+b 


al 




06 


15 


4300H+b 


•1 




07 


•• 


4380H+b 


• 1 




08 


16 


4400H+b 


• 1 




09 


■• 


4480H+b 


II 




10 


17 


4500H+b 


•1 




11 


ii 


4580H+b 


•I 




12 


18 


4600H+b 


" 




13 


•• 


4680H+b 


•1 




14 


19 


4700H+b 


II 




15 


•< 


4780H+b 


II 




16 


20 


4800H+b 


II 




17 


•« 


4880H+b 


■ 1 




18 


21 


4900H+b 


II 


01 


19 


ii 


4980H+b 


BDOS 


01 


20 


22 


4A0 0H+b 


BIOS 


•i 


21 


ii 


4A80H+b 


ii 


ii 


23 


23 


4B00H+b 


ii 


•I 


24 


H 


4B80H+b 


a 


i« 


25 


24 


4C00H+b 


ti 


01 


26 


■I 


4C80H+b 


BIOS 



02-76 01-26 



(directory and data) 
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6. THE BIOS ENTRY POINTS 



into the BIOS from the cold start loader and BDOS 
Entry to the BIOS is through a "jump vector" 
as shown below (see Appendices B and C, as well). 
sequence of 17 jump instructions which send 
the individual BIOS subroutines. The BIOS 
subroutines may be empty for certain functions (i.e., they may contain 
a single RET operation) during regeneration of CP/M, but the entries 
must be present in the jump vector. 



The entry points 
are detailed below, 
located at 4A00H+b, 
The jump vector is a 
program control to 



The jump vector at 4A00H+b takes the form shown below, 
individual jump addresses are given to the left: 



where the 



4A00H+O 


J MP 


BOOT 


4A0 3H+D 


J MP 


WBOOT 


4A06H+b 


J MP 


CONST 


4A09H+b 


J MP 


CON IN 


4A0CH+b 


J MP 


CONOUT 


4A0FH+P 


J MP 


LIST 


4Al2ri+b 


J MP 


PUNCH 


4Al5H+b 


J MP 


READER 


4A18H+P 


J MP 


HOME 


4AlBH+b 


J MP 


SELDSK 


4A1EH+0 


J MP 


SETTRK 


4A21H+D 


J MP 


SETS EC 


4A24H+D 


J MP 


SETDMA 


4A27H+b 


J MP 


READ 


4A2AH+D 


J MP 


WRITE 


4A2DH+b 


J MP 


LISTST 


4A30H+b 


J MP 


SECT RAN 



ARRIVE HERE FROM COLD START LOAD 

ARRIVE HERE FOR 'WARM START 

CHECK FOR CONSOLE CHAR READY 

READ CONSOLE CHARACTER IN 

WRITE CONSOLE CHARACTER OUT 

WRITE LISTING CHARACTER OUT 

WRITE CHARACTER TO PUNCH DEVICE 

READ READER DEVICE 

MOVE TO TRACK ON SELECTED DISK 

SELECT DISK DRIVE 

SET TRACK NUMBER 

SET SECTOR NUMBER 

SET DMA ADDRESS 

READ SELECTED SECTOR 

WRITE SELECTED SECTOR 

RETURN LIST STATUS 

SECTOR TRANSLATE SUBROUTINE 



Each jumo address corresponds to a particular subroutine which 
performs the specific function, as outlined below. There are three 
major divisions in the jump table: the system (re) initialization 
whicn results from calls on BOOT and WBOOT, simple character I/O 
performed by calls on CONST, CONIN, CONOUT, LIST, PUNCH, READER, and 
LISTST, and diskette I/O performed by calls on HOME, SELDSK, SETTRK, 
SETS EC, SETDMA, READ, WRITE, and SECTRAN. 

All simple character I/O operations are assumed to be performed in 
ASCII, upper and lower case, with high order (parity bit) set to zero. 
An end-of-file condition for an input device is given by an ASCII 
control-z (1AH) . Peripheral devices are seen by CP/M as "logical" 
devices, and are assigned to physical devices within the BIOS. 

In order to operate, the BDOS needs only the CONST, CONIN, and 
CONOUT subroutines (LIST, PUNCH, and READER may be used py PIP, but 
not the BDOS) . Further, the LISTST entry is used currently only by 
DESPOOL, and thus, the initial version of CBIOS may have empty 
subroutines for the remaining ASCII devices. 
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The characteristics of each device are 



CONSOLE 



LIST 



PUNCH 



READER 



The principal interactive console wnich communicates 
with the operator, accessed through CONST, CONIN, and 
CONOUT. Typically, the CONSOLE is a device such as a 
CRT or Teletype. 

The principal listing device, if it exists on your 
system, which is usually a hard-copy device, such as a 
printer or Teletype. 

The principal tape punching device, if it exists, which 
is normally a high-speed paper tape punch or Teletype. 



The principal tape reading device, 
optical reader or Teletype. 



Note that a 
the LIST, PUNC 
no peripheral d 
READER device, 
an appropriate 
not "hang" if t 
other user pr 
routines can ju 
can return with 
immediate end-o 



single per 
H, and READ 
evice is as 
the CBIOS c 
error me 
he device i 
ogram. Al 
st simply r 

a 1AH" (ctl 
f-f ile. 



ipheral c 
ER device 
signed as 
reated by 
ssage so 
s accesse 
ternately 
eturn, an 
-Z) in 



such as a simple 



an be assigned as 

simultaneously. If 

the LIST, PUNCH, or 

the user may give 

that the system does 

d by PIP or some 

, the PUNCH and LIST 

d the READER routine 

reg A to indicate 



For adde 
implement t 
reassignment 
IOBYTE fun 
physical dev 
processing 
the IOBYTE f 
as follows: 
location 000 
defines the 
in effect 
performed by 
fields of 
PUNCH, and L 



d flexibility, the 
he "IOBYTE" func 

of physical and 
ction creates a m 
ices which can be 
(see the STAT comma 
unction corresponds 

a single locati 
3H) is maintained, 
logical to physical 
at a particular t 
splitting the IOBYT 
two bits each, call 
1ST fields, as shown 



user can ootionally 
tion wnich allows 

logical devices. The 
apping of logical to 
altered during CP/M 
nd) . The definition of 
to the Intel standard 
on in memory (currently 

called IOBYTE, which 
device mapping which is 
ime. The mapping is 
E into four distinct 
ed the CONSOLE, READER, 

below: 



most significant 
IOBYTE AT 0003H I LIST I PUNCH 



least significant 
READER I CONSOLE I 



bits 6,7 bits 4,5 bits 2,3 bits 0,1 

The value in each field can be in the range 0-3, 
defining the assigned source or destination of each 
logical device. The values which can be assigned to 
each field are given below 
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CONSOLE field (bits 0,1) 

- console is assigned to tne console printer device (TTY:) 

1 - console is assigned to the CRT device (CRT:) 

2 - batch mode: use the READER as the CONSOLE input, 

and the LIST device as the CONSOLE output (BAT:) 

3 - user defined console device (UC1:) 

READER field (bits 2,3) 

- READER is the Teletype device (TTY:) 

1 - READER is the high-speed reader device (RDR:) 

2 - user defined reader # 1 (UR1:) 

3 - user defined reader # 2 (UR2:) 

PUNCH field (bits 4,5) 

- PUNCH is the Teletype device (TTY:) 

1 - PUNCH is the high speed punch device (PUN:) 

2 - user defined punch # 1 (UPl:) 

3 - user defined puncn # 2 (UP2:) 

LIST field (bits 6,7) 

- LIST is the Teletype device (TTY:) 

1 - LIST is the CRT device (CRT:) 

2 - LIST is the line printer device (LPT:) 

3 - user defined list device (ULl:) 

Note again that the implementation of the IOBYTE is 
optional, and affects only the organization of your 
CBIOS. No CP/M systems use the IOBYTE (although they 
tolerate the existence of the IOBYTE at location 
0tf03H) , except for PIP which allows access to the 
physical devices, and STAT which allows 
logical-physical assignments to be made and/or 
displayed (for more information, see the "CP/M Features 
and Facilities Guide"). In any case, the IOBYTE 
imolementation should be omitted until your basic CBIOS 
is fully implemented and tested; then add the IOBYTE to 
increase your facilities. 

Disk I/O is always performed through a sequence of 
calls on the various disk access subroutines which set 
up the disk number to access, the track and sector on a 
particular disk, and the direct memory access (DMA) 
address involved in the I/O operation. After all these 
parameters have been set up, a call is made to the READ 
or WRITE function to perform the actual I/O operation. 
Note that there is often a single call to SELDSK to 
select a disk drive, followed by a number of read or 
write operations to the selected disk before selecting 
another drive for subsequent operations. Similarly, 
there may be a single call to set the DMA address, 
followed by several calls which read or write from the 
selected DMA address oefore the DMA address is changed. 
The track and sector subroutines are always called 
before tne READ or WRITE ooerations are performed. 
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Wote that the READ and WRITE routines should 
perform several retries (10 is standard) before 
reporting the error condition to the BDOS. If the 
error condition is returned to the BDOS, it will report 
the error to the user. The HOME subroutine may or may 
not actually perform the track 00 seek , depending upon 
your controller characteristics; the important point is 
that track 00 has been selected for the next operation, 
and is often treated in exactly the same manner as 
SETTRK with a parameter of 00. 

The exact responsibili tes of eacn entry point 
subroutine are given below: 

BOOT The BOOT entry point gets control from the cold start 
loader and is responsible for basic system 
initialization, including sending a signon message 
(which can be omitted in the first version) . If the 
IOBYTE function is implemented, it must be set at this 
point. The various system parameters whicn are set by 
the WBOOT entry point must be initialized, and control 
is transferred to the CCP at 3400H+b for further 
processing. Mote that reg C must be set to zero to 
select drive A. 

WBOOT The WBOOT entry point gets control when a warm start 
occurs. A warm start is performed whenever a user 
program branches to location 0000H, or when the CPU is 
reset from the front panel. The CP/M system must be 
loaded from the first two tracks of drive A up to, but 
not including, the BIOS (or CBIOS, if you have 
completed your patch) . System parameters must be ini- 
tialized as shown below: 

location 0,1,2 set to JMP WBOOT for warm starts 

(0000H: JMP 4A03H+b) 

location 3 set initial value of IOBYTE, if 

implemented in your CBIOS 

location 5,6,7 set to JMP BDOS, which is the 
primary entry point to CP/M for 
transient programs. (0005H: JMP 
3C06K+b) 

(see Section 9 for complete details of page zero use) 
Upon completion of the initialization, the WBOOT 
program must branch to the CCP at 3400H+b to (re) start 
the system. Upon entry to the CCP, register C is set 
to the drive to select after system initialization. 

CONST Sample the status of the currently assigned console 

device and return 0FFH in register A if a character is 

ready to read, and 00H in register A if no console 

characters are ready. 

CONIN Read the next console character into register A, and 
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CONOUT 



LIST 



PUNCH 



READER 



HOME 



SELD3K 



Send the character from i 
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set the parity pit (high order bit) to zero. If no 
console character is ready, wait until a character is 
typed oefore returning. 



C to the console 

in ASCII, with high 

may want to include 

age return, if your 

interval at the end 

00 terminal) . You 

rol characters which 

in a strange way (a 

terminal to clear 



Send the character from register C to the currently 
assigned listing device. The character is in ASCII 
with zero parity. 

Send the character from register C to the currently 
assigned punch device. The character is in ASCII with 
zero parity. 

Read the next character from the currently assigned 
reader device into register A with zero parity (high 
order bit must be zero) , an end of file condition is 
reported by returning an ASCII control-z (1AH) . 

Return the disk head of the currently selected disk 
(initially disk A) to the track 00 position. If your 
controller allows access to the track flag from the 
drive, step the head until the track flag is 
detected. If your controller does not support this 
feature, you can translate the HOME call into a call 
on SETTRK with a parameter of 0. 

Select the disk drive given by register C for further 
operations, where register C contains for drive A, 1 
for drive B, and so-forth up to 15 for drive P (the 
standard CP/M distribution version supports four 
drives) . On each disk select, SELDSK must return in 
HL the base address of a 16-byte area, called the Disk 
Parameter Header, described in the Section 10. For 
standard floppy disk drives, the contents of the 
header and associated tables does not change, and thus 
the program segment included in the sample CBIOS 
performs this operation automatically. If there is an 
attempt to select a non-existent drive, SELDSK returns 
HL=0000H as an error indicator. Although SELDSK must 
return the header address on each call, it is 
advisable to postpone the actual physical disk select 
operation until an I/O function (seek, read or write) 
is actually performed, since disk selects often occur 
without utimately performing any disk I/O, and many 
controllers will unload the head of the current disk 
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before selecting the new drive. This would cause an 
excessive amount of noise and disk wear. 

SETTRK Register BC contains the track number for subseauent 
disk accesses on the currently selected drive. ¥ou 
can choose to seek the selected track at this time, or 
delay the seek until the next read or write actually 
occurs. Register BC can take on values in the range 
0-76 corresponding to valid track numbers for standard 
floppy disk drives, and 0-65535 for non-standard disk 
subsystems. 

SETSEC Register BC contains the sector number (1 through 26) 
for subsequent disk accesses on the currently selected 
drive. Zou can choose to send this information to the 
controller at this point, or instead delay sector 
selection until a read or write operation occurs. 

SETDMA Register 3C contains the DMA (disk memory access) 
address for subsequent read or write operations. For 
example, if B = 00H and C = 80H when SETDMA is called, 
then all subsequent read operations read their data 
into 80H through 0FFH, and all subsequent write 
operations get their data from 8SH through 0FFH, until 
the next call to SETDMA occurs. The initial DMA 
address is assumed to be 80H. Note that the 
controller need not actually support direct memory 
access. If, for example, all data is received and 
sent through I/O oorts, the CBIOS which you construct 
will use the 128 byte area starting at the selected 
DMA address for the memory buffer during the following 
read or write operations. 

READ Assuming the drive has been selected, the track has 
been set, the sector has been set, and the DMA aadress 
has been specified, the READ subroutine attempts to 
read one sector based upon these parameters, and 
returns the following error codes in register A: 

no errors occurred 

1 non-recoverable error condition occurred 

Currently, CP/M responds only to a zero or non-zero 
value as tne return code. That is, if the value in 
register A is then CP/M assumes that the disk 
operation completed properly. If an error occurs, 
however, the CBIOS should attempt at least 10 retries 
to see if the error is recoverable. When an error is 
reported the BDOS will print the message "BDOS ERR ON 
x: BAD SECTOR". The operator then has the option of 
typing <cr> to ignore the error, or ctl-C to abort. 

WRITE Write the data from the currently selected DMA address 
to the currently selected drive, track, and sector. 
The data should be marked as "non deleted data" to 
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maintain compatibility with other CP/M systems. The 
error codes given in the READ command are returned in 
register A, with error recovery attempts as described 
above. 

LISTS'! Return the ready status of the list device. Used by 
the DESPOOL program to improve console response during 
its operation. The value 00 is returned in A if the 
list device is not ready to accept a character, and 
0FFH if a character can be sent to the printer. Note 
that a 00 value always suffices. 

SECTRAN Performs sector logical to physical sector translation 
in order to improve the overall response of CP/M. 
Standard CP/M systems are shipped with a "skew factor" 
of 6, where six physical sectors are skipped between 
each logical read operation. This skew factor allows 
enough time between sectors for most programs to load 
their buffers witnout missing the next sector. In 
particular computer systems which use fast processors, 
memory, and disk subsystems, the skew factor may be 
changed to improve overall response. Note, however, 
that you should maintain a single density IBM 
compatible version of CP/M for information transfer 
into and out of your computer system, using a skew 
factor of 6. In general, SECTRAN receives a logical 
sector number in BC , and a translate table address in 
DE. The sector number is used as an index into the 
translate table, with the resulting physical sector 
number in BL. For standard systems, the tables and 
indexing code is orovided in the C3I0S and need not be 
changed. 
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7. A SAMPLE BIOS 

The program shown in Appendix C can serve as a basis for your 
first BIOS. The simplest functions are assumed in this BIOS r so that 
you can enter it through the front panel, if absolutely necessary. 
Note that the user must alter and insert code into the subroutines for 
CONST, CONIN, CONOUT, READ, WRITE, and WAITIO subroutines. Storage is 
reserved for user-supplied code in these regions. The scratch area 
reserved in page zero (see Section 9) for the BIOS is used in this 
program, so that it could be implemented in ROM, if desired. 

Once operational, this skeletal version can be enhanced to print 
the initial sign-on message and perform better error recovery. The 
subroutines for LIST, PUNCH, and READER can be filled-out, and the 
IOBYTE function can be implemented. 
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3. A SAMPLE COLD START LOADER 

The program shown in Appendix D can serve as a basis for your cold 
start loader. The disk read function must De supplied by the user, 
ana the program must be loaded somehow starting at location 0000. 
Note that space is reserved for your patch so that the total amount of 
storage required for the cold start loader is 128 bytes. Eventually, 
you will probably want to get this loader onto the first disk sector 
(tracK 0, sector 1), and cause your controller to load it into memory 
automatically upon system start-up. Alternatively, you may wish to 
place tne cold start loader into ROM, and place it above the CP/M 
system. In this case, it will oe necessary to originate the program 
at a nigner address, and key-in a jump instruction at system start-up 
which brancnes to the loader. Subsequent warm starts will not require 
this key-in operation, since the entry point 'WBOOT' gets control, 
thus bringing the system in from disk automatically. Note also that 
the skeletal cold start loader has minimal error recovery, which may 
oe enhanced on later versions. 
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9. RESERVED LOCATIONS IN PAGE ZERO 

Main memory page zero, between locations 00H and 0FFH r contains 
several segments of code and data which are used during CP/M 
processing. The code and data areas are given below for reference 
purposes. 

Locations Contents 

from to 

0000H - 0002H Contains a jump instruction to the warm start 

entry point at location 4A03H+O. This allows a 
simple programmed restart (JHP 0000H) or manual 
restart from the front oanel. 

0003H - 0003H Contains the Intel standard IOBYTE, which is 

optionally included in the user's C3I0S r as 
described in Section 6. 

0004H - 0004H Current default drive number (0=A, . . . , 15=P) . 

0005H - 0007H Contains a jump instruction to the BDOS,and 

serves two purposes: JMP 00&5H provides the 
primary entry point to the BDOS r as described in 
the manual "CP/M Interface Guide," and LHLD 
0006H brings the address field of the 
instruction to the HL register pair. This value 
is the lowest address in memory used by CP/M 
(assuming the CCP is being overlayed) . Note 
that the DDT program will change the address 
field to reflect the reduced memory size in 
debug mode. 

0008H - 0027H (interrupt locations 1 through 5 not used) 

0030H - 0037H (interrupt location 6, not currently used 

reserved) 

0038H - 003AH Restart 7 - Contains a jump instruction into tne 

DDT or SID program when running in debug mode 
for orogrammed breakpoints, but is not otherwise 
used by CP/M. 

003BH - G03FH (not currently used - reserved) 

0040H - 004FH 16 byte area reserved for scratch by CBIOS, but 

is not used for any purpose in the distribution 
version of CP/M 

0050H - 005BH (not currently used - reserved) 

005CH - 007CH default file control block produced for a 

transient program by the Console Command 
Processor. 

007DH - 007FH Optional default random record position 
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0080H - 00FFH default 128 byte disk buffer (also filled with 

the command line when a transient is loaded 
under the CCP) . 



Note that this information is set-up for normal operation under 
the CP/M system, but can be overwritten by a transient program if the 
BDOS facilities are not required by the transient. 

If r for example, a particular program performs only simple I/O and 
must begin execution at location 0, it can be first loaded into the 
TPA, using normal CP/M facilities, with a small memory move program 
which gets control when loaded (the memory move program must get 
control from location 0100H, which is the assumed beginning of all 
transient programs) . The move program can then proceed to move the 
entire memory image down to location 0, ana pass control to the 
starting address of the memory load. t^lote that if the BIOS is 
overwritten, or if location (containing the warm start entry point) 
is overwritten, then the programmer must bring the CP/M system back 
into memory v/ith a cold start sequence. 
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10. DISK PARAMETER TABLES. 

Tables are included in the BIOS which describe the particular 
characteristics of the disk subsystem used with CP/M. These tables 
can be either hand-coded r as shown in the sample CBIOS in Appendix C, 
or automatically generated using the DISKDEF macro library, as shown 
in Appendix B. The purpose here is to describe the elements of these 
tables. 

In general, each disk drive has an associated (16-byte) disk 
parameter header which both contains information about the disk drive 
and provides a scratchpad area for certain BDOS operations. The 
format of the disk parameter header for each drive is shown below 

Disk Parameter Header 

I XLT I 0000 I 0000 I 0000 IDIRBUFI DPB I CSV I ALV I 

16b 16b 16b 16b 16b 16b 16b 16b 

where each element is a word (16-bit) value. The meaning of each Disk 
Parameter Header (DPH) element is 

XLT Address of the logical to physical translation vector, 
if used for this particular drive, or the value 0000H 
if no sector translation takes place (i.e, the physical 
and logical sector numbers are the same) „ Disk drives 
with identical sector skew factors share the same 
translate tables. 

0000 Scratchpad values for use within the BDOS (initial 
value is unimportant) . 

DIRBUF Address of a 128 byte scratchpad area for directory 
operations within BDOS. Ail DPH ' s address the same 
scratchpad area. 

DPB Address of a disk parameter block for this drive. 
Drives with identical disk characteristics address the 
same disk parameter block. 

CSV Address of a scratchpad area used for software check 
for changed disks. This address is different for each 
DPH. 

ALV Address of a scratchpad area used by the BDOS to keep 
disk storage allocation information. This address is 
different for each DPH. 

Given n disk drives, the DPH ' s are arranged in a table whose first row 
of 16 bytes corresponds to drive 0, with the last row corresponding to 
drive n-1 . The table thus appears as 
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DPBASE: 

00 IXLT 001 0000 I 0000 I 0000 iDIRBUFlDBP 00|CSV 00|ALV 00 I 

01 |XLT 011 0000 I 0000 I 0000 IDIRBUFlDBP 01|CSV 01|ALV 01 1 

(and so-forth through) 
n-llXLTn-ll 0000 | 0000 | 0000 | DIRBUF I DBPn-1 I CSVn-1 | ALVn-1 | 

where the label DPBASE defines the base address of the DPH table. 

A responsibility of the SELDSK subroutine is to return the base 
address of the DPH for the selected drive. The following sequence of 
operations returns the table address, with a 0000H returned if the 
selected drive does not exist. 



NDISKS 
SELDSK: 



EQU 



4 ;NUMBER OF DISK DRIVES 



;SELECT DISK GIVEN BY BC 
LXI H,0000H ;ERROR CODE 
MOV A r C ; DRIVE OK? 
CPI NDISKS ;CY IF SO 
RNC ;RET IF ERROR 

;NO ERROR, CONTINUE 



MOV 


L, 


C J 


LOW (DISK) 


MOV 


H, 


B 


•HIGH(DISK) 


DAD 


H 




•*2 


DAD 


H 




,* 4 


DAD 


H 




;*8 


DAD 


H 




•*16 


LXI 


D, 


DPBASE 


; FIRST DPH 


DAD 


D 




•DPH (DISK) 


RET 









The translation vectors (XLT 00 through XLTn-1) are located 
elsewhere in the BIOS, and simply correspond one-for-one with the 
logical sector numbers zero through the sector count-1. The Disk 
Parameter Block (DPB) for each drive is more complex. A particular 
DPB, which is addressed by one or more DPH's, takes the general form 



I SPT iBSHlBLMlEXMl DSM 
16b 8b 8b 8b 16b 



DRM |AL0|AL1| CKS I OFF I 
16b 8b 8b 16b 16b 



where each is a byte or word value, as shown by the "8b" or "16b" 
indicator below the field. 



SPT 



is the total number of sectors per track 



BSH is the data allocation block shift factor, determined 
by the data block allocation size. 
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EXM is the extent mask, determined by the data block 
allocation size and the number of disk blocks. 

DSM determines the total storage capacity of the disk drive 

DRM determines the total number of directory entries which 
can be stored on this drive AL0 ,AL1 determine reserved 
directory blocks. 

CKS is the size of the directory check vector 

OFF is the number of reserved tracks at the beginning of 
the (logical) disk. 

The values of BSH and BLM determine (implicitly) the data allocation 
size BLS, which is not an entry in the disk parameter block. Given 
that the designer has selected a value for BLS, the values of BSH and 
BLM are shown in the table below 

BLS BSH BLM 

1,024 3 7 

2,048 4 15 

4,096 5 31 

8,192 6 63 

16,384 7 127 

where all values are in decimal. The value of EXM depends upon both 
the BLS and whether the DSM value is less than 256 or greater than 
255, as shown in the following table 

BLS DSM < 256 DSM > 255 
1,024 N/A 

2,048 1 

4,096 3 1 

8,192 7 3 

16,384 15 7 

The value of DSM is the maximum data block number supported by 
this particular drive, measured in BLS units. The product BLS times 
(DSM+1) is the total number of bytes held by the drive and, of course, 
must be within the capacity of the physical disk, not counting the 
reserved operating system tracks. 

The DRM entry is the one less than the total number of directory 
entries, which can take on a 16-bit value. The values of AL0 and ALl , 
however, are determined by DRM. The two values AL0 and ALl can 
together be considered a string of 16-bits, as shown below. 
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AL0 I ALl 



00 01 02 03 04 05 06 07 08 09 10 11 12 13 14 15 

where position 00 corresponds to the high order bit of the byte 
labelled AL0 , and 15 corresponds to the low order bit of the byte 
labelled ALL Each bit position reserves a data block for number of 
directory entries, thus allowing a total of 16 data blocks to be 
assigned for directory entries (bits are assigned starting at 00 and 
filled to the right until position 15). Each directory entry occupies 
32 bytes, resulting in the following table 



BLS 


Directory 


Entries 


1,024 


3 2 times 


# 


bits 


2,048 


6 4 times 


# 


bits 


4,096 


128 times 


# 


bits 


8,192 


256 times 


# 


bits 


16,384 


512 times 


# 


bits 



Thus, if DRM = 127 (128 directory entries) , and BLS = 1024, then there 
are 32 directory entries per block, requiring 4 reserved blocks. In 
this case, the 4 hiqh order bits of AL0 are set, resulting in the 
values AL0 = 0F0H and ALl = 00H. 

The CKS value is determined as follows: if the disk drive media 
is removable, then CKS = (DRM+l)/4, where DRM is the last directory 
entry number. If the media is fixed, then set CKS = (no directory 
records are checked in this case) . 

finally, the OFF field determines the number of tracks which are 

skipped at the beginning of the physical disk. This value is 

automatically added whenever SETTRK is called, and can be used as a 

mechanism for skipping reserved operating system tracks, or for 

partitioning a large disk into smaller segmented sections. 

To complete the discussion of the DPB , recall that several DPH * s 
can address the same DPB if their drive characteristics are identical. 
Further, the DPB can be dynamically changed when a new drive is 
addressed by simply changing the pointer in the DPH since the BDOS 
copies the DPB values to a local area whenever the SELDSK function is 
invoked. 

Returning back to the DPH for a particular drive, note that the 
two address values CSV and ALV remain. Both addresses reference an 
area of uninitialized memory following the BIOS. The areas must be 
unique for each drive, and the size of each area is determined by the 
values in the DPB. 

The size of the area addressed by CSV is CKS bytes, which is 
sufficient to hold the directory check information for this particular 
drive. If CKS = (DRM+D/4, then you must reserve (DRM+D/4 bytes for 
directory check use. If CKS = 0, then no storage is reserved. 
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The size of the area addressed by ALV is determined by the 
maximum number of data blocks allowed for this particular disk r and is 
computed as (DSM/8)+l. 

The CBIOS shown in Appendix C demonstrates an instance of these 

tables for standard 8" single density drives. It may be useful to 

examine this program, and compare the tabular values with the 
definitions given above. 



(All Information Contained Herein is Proprietary to Digital Research.) 

29 



11. THE DISKDEF MACRO LIBRARY. 

A macro library is shown in Appendix F f called DISKDEF, which 
greatly simplifies the table construction process. You must have 
access to the MAC macro assembler, of course, to use the DISKDEF 
facility, while the macro library is included with all CP/M 2.0 
distribution disks. 

A BIOS disk definition consists of the following sequence of 
macro statements: 

MACLIB DISKDEF 

• ••••• 

DISKS n 
DISKDEF 0,... 
DISKDEF 1,... 



DISKDEF n-1 

ENDEF 

where the MACLIB statement loads the DISKDEF. LIB file (on the same 
disk as your BIOS) into MAC ' s internal tables. The DISKS macro call 
follows, which specifies the number of drives to be configured with 
your system, where n is an integer in the range 1 to 16. A series of 
DISKDEF macro calls then follow which define the characteristics of 
each logical disk, through n-1 (corresponding to logical drives A 
through P) . Note that the DISKS and DISKDEF macros generate the 
in-line fixed data tables described in the previous section, and thus 
must be placed in a non-executable portion of your BIOS, typically 
directly following the BIOS jump vector. 

The remaining portion of your BIOS is defined following the 
DISKDEF macros, with the ENDEF macro call immediately preceding the 
END statement. The ENDEF (End of Diskdef) macro generates the 
necessary uninitialized RAM areas which are located in memory above 
your BIOS. 

The form of the DISKDEF macro call is 

DISKDEF dn,fsc,lsc, [skf] ,bls ,dks,dir ,cks,of s, [0] 

dn is the logical disk number, to n-1 

fsc is the first physical sector number (0 or 1) 

lsc is the last sector number 

skf is the optional sector skew factor 

bis is the data allocation block size 

dir is the number of directory entries 

cks is the number of "checked" directory entries 

ofs is the track offset to logical track 00 

[0] is an optional 1.4 compatibility flag 

The value "dn" is the drive number being defined with this DISKDEF 
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where 



macro invocation. The "fsc" parameter accounts for differing sector 
numbering systems, and is usually or 1. The "lsc" is the last 
numbered sector on a track. When present, the "skf" parameter defines 
the sector skew factor which is used to create a sector translation 
table according to the skew. If the number of sectors is less than 
256, a single-byte table is created, otherwise each translation table 
element occupies two bytes. No translation table is created if the 
skf parameter is omitted (or equal to 0) . The "bis" parameter 
specifies the number of bytes allocated to each data block, and takes 
on the values 1024, 2048, 4096, 8192, or 16384. Generally, 
performance increases with larger data block sizes since there are 
fewer directory references and logically connected data records are 
physically close on the disk. Further, each directory entry addresses 
more data and the BIOS-resident ram space is reduced. The "dks" 
specifies the total disk size in "bis" units. That is, if the bis 
2048 and dks = 1000, then the total disk capacity is 2,048,000 bytes. 
If dks is greater than 255, then the block size parameter bis must be 
greater than 1024. The value of "dir" is the total number of 
directory entries which may exceed 255, if desired. The "cks" 
parameter determines the number of directory items to check on each 
directory scan, and is used internally to detect changed disks during 
system operation, where an intervening cold or warm start has not 
occurred (when this situation is detected, CP/M automatically marks 
the disk read/only so that data is not subsequently destroyed) . As 
stated in the previous section, the value of cks = dir when the media 
is easily changed, as is the case with a floppy disk subsystem. If 
the disk is permanently mounted, then the value of cks is typically 0, 
since the probability of changing disks without a restart is quite 
low. The "ofs" value determines the number of tracks to skip when 
this particular drive is addressed, which can be used to reserve 
additional operating system space or to simulate several logical 
drives on a single large capacity physical drive. Finally, the [0] 
parameter is included when file compatibility is required with 
versions of 1.4 which have been modified for higher density disks. 
This parameter ensures that only 16K is allocated for each directory 
record, as was the case for previous versions. Normally, this 
parameter is not included. 

For convenience and economy of table space, the special form 

DISKDEF i,j 

gives disk i the same characteristics as a previously defined drive j. 
A standard four-drive single density system, which is compatible with 
version 1.4, is defined using the following macro invocations: 
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DISKS 

DISKDEF 

DISKDEF 

DISKDEF 

DISKDEF 

• • • • 

ENDEF 



0,1,26,6,10 24,243,64,64,2 

1,0 

2,0 

3,0 



with all disks having the same parameter values of 26 sectors per 
track (numbered 1 through 26) , with 6 sectors skipped between each 
access, 1024 bytes per data block, 243 data blocks for a total of 243k 
byte disk capacity, 64 checked directory entries, and two operating 
system tracks. 

The DISKS macro generates n Disk Parameter Headers (DPH's), 
starting at the DPH table address DPBASE generated by the macro. Each 
disk header block contains sixteen bytes, as described above, and 
correspond one-for-one to each of the defined drives. In the four 
drive standard system, for example, the DISKS macro generates a table 
of the form: 



DPBASE 

DPE0 

DPE1 

DPE2 

DPE3 



EQU 

DW 

DW 

DW 

DW 



XLT0,0 00H f 000H,0 000H,DIRBUF,DPB0,CSV0,ALV0 
XLT0,0 00H,0 00H,0 000H r DIRBUF,DPB0,CSVl,ALVl 
XLT0,0 00H,0 00H,0 00H,DIRBUF,DPB0,CSV2,ALV2 
XLT0,0 00H,0 000H,0 000H,DIRBUF,DPB0,CSV3,ALV3 



where the DPH laoels are included for reference purposes to show the 
beginning table addresses for each drive through 3. The values 
contained within the disk parameter header are described in detail in 
the previous section. The check and allocation vector addresses are 
generated by the ENDEF macro in the ram area following the BIOS code 
and tables. 



Note that if the "skf" (s 
equal to 0) , the translation 
inserted in the XLT position of 
disk. In a subsequent cal 
translation, SECTRAN receives a 
0000H, and simply returns the 
HL register pair. A translate 
parameter is present, and the 
the corresponding DPH's. The 
constructed when the standard 
DISKDEF macro call: 



kew factor) parameter is omitted (or 

table is omitted, and a 0000H value is 

the disk parameter header for the 

1 to perform the logical to physical 

translation table address of DE = 

original logical sector from BC in the 

table is constructed when the skf 

(non-zero) table address is placed into 

table shown below, for example, is 

skew factor skf = 6 is specified in the 



XLT0: DB 1,7,13,19,25,5,11,17,23,3,9,15,21 
DB 2,8,14,20,26,6,12,18,24,4,10,16,22 

Following the ENDEF macro call, a number of uninitialized data 
areas are defined. These data areas need not be a part of the BIOS 
which is loaded upon cold start, but must be available between the 
BIOS and the end of memory. The size of the uninitialized RAM area is 
determined by EQU statements generated by the ENDEF macro. For a 
standard four-drive system, the ENDEF macro might produce 
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4C72 = BEGDAT EQU $ 
(data areas) 
4DB0 = ENDDAT EQU $ 
013C = DATSIZ EQU $-BEGDAT 

which indicates that uninitialized RAM begins at location 4C72H r ends 
at 4DB0H-1, and occupies 013CH bytes. You must ensure that these 
addresses are free for use after the system is loaded. 

After modification, you can use the STAT program to check your 
drive characteristics, since STAT uses the disk parameter block to 
decode the drive information. The STAT command form 

STAT d:DSK: 

decodes the disk parameter block for drive d (d=A r ...,P) and displays 
the values shown below: 

r: 128 Byte Record Capacity 

k: Kilobyte Drive Capacity 

d: 32 Byte Directory Entries 

c: Checked Directory Entries 

e: Records/ Extent 

b: Records/ Block 

s: Sectors/ Track 

t: Reserved Tracks 

Three examples of DISKDEF macro invocations are shown below with 
corresponding STAT parameter values (the last produces a full 
8-megabyte system) . 

DISKDEF 0,1,58, ,2048 r 256 r l 28,128, 2 
r=4096, k=512, d=128, c=128, e=256, b=16, s=58, t=2 

DISKDEF 0,1, 58, ,20 48, 10 24, 300, 0,2 
r=16384, k = 2048, d=300, c=0 , e=128 r b=16, s = 58, t = 2 

DISKDEF 0,1,58, ,16384,512,128,128,2 
r=65536, k=8192, d=128, c=128, e=1024, b=128, s=58, t=2 
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12. SECTOR BLOCKING AND DEBLOCKING. 

Upon each call to the BIOS WRITE entry point, the CP/M BDOS 
includes information which allows effective sector blocking and 
deblocking where the host disk subsystem has a sector size which is a 
multiple of the basic 128-byte unit. The purpose here is to present a 
general-purpose algorithm which can be included within your BIOS which 
uses the BDOS information to perform the operations automatically. 

Upon each call to WRITE, the BDOS provides the following 
information in register C: 

= normal sector write 

1 = write to directory sector 

2 = write to the first sector 

of a new data block 

Condition occurs whenever the next write operation is into a 
previously written area, such as a random mode record update, when the 
write is to other than the first sector of an unallocated block, or 
when the write is not into the directory area. Condition 1 occurs 
when a write into the directory area is performed. Condition 2 occurs 
when the first record (only) of a newly allocated data block is 
written. In most cases, application programs read or write multiple 
128 byte sectors in sequence, and thus there is little overhead 
involved in either operation when blocking and deblocking records 
since pre-read operations can be avoided when writing records. 

Appendix G lists the blocking and deblocking algorithms in skeletal 
form (this file is included on your CP/M disk). Generally, the 
algorithms map all CP/M sector read operations onto the host disk 
through an intermediate buffer which is the size of the host disk 
sector. Throughout the program, values and variables which relate to 
the CP/M sector involved in a seek operation are prefixed by "sek," 
while those related to the host disk system are prefixed by "hst. " 
The equate statements beginning on line 29 of Appendix G define the 
mapping between CP/M and the host system, and must be changed if other 
than the sample host system is involved. 

The entry points BOOT and WBOOT must contain the initialization 
code starting on line 57, while the SELDSK entry point must be 
augmented by the code starting on line 65. Note that although the 
SELDSK entry point computes and returns the Disk Parameter Header 
address, it does not physically selected the host disk* at this point 
(it is selected later at READHST or WRITEHST) . Further, SETTRK, 
SETTRK, and SETDMA simply store the values, but do not take any other 
action at this point. SECTRAN performs a trivial trivial function of 
returning the physical sector number. 

The principal entry points are READ and WRITE, starting on lines 
110 and 125, respectively. These subroutines take the place of your 
previous READ and WRITE operations. 

The actual physical read or write takes place at either WRITEHST 
or READHST, where all values have been prepared: hstdsk is the host 
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disk number, hsttrk is the host track number, and hstsec is the host 
sector number (which may require translation to a physical sector 
number) . You must insert code at this point which performs the full 
host sector read or write into, or out of, the buffer at hstbuf of 
length hstsiz. All other mapping functions are performed by the 
algorithms. 

This particular algorithm was tested using an 80 megabyte hard 
disk unit which was originally configured for 128 byte sectors, 
producing approximately 35 megabytes of formatted storage. When 
configured for 512 byte host sectors, usable storage increased to 57 
megabytes, with a corresponding 400% improvement in overall response. 
In this situation, there is no apparent overhead involved in 
deblocking sectors, with the advantage that user programs still 
maintain the (less memory consuming) 128-byte sectors. This is 
primarily due, of course, to the information provided by the BDOS 
which eliminates the necessity for pre-read operations to take place. 
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APPENDIX A: THE MDS COLD START LOADER 



0000 
ffff 
0000 



0000 = 

0000 = 

0806 = 

1880 = 

1600 = 

1603 = 

3000 

1880 = 

0002 = 
0031 = 
0019 = 
0018 = 

f800 = 
ff0f - 

0078 = 

0079 = 
007b = 
007f = 

0078 = 

0079 = 
007a = 
00ff = 

0003 = 

0004 = 
0100 = 



MDS-800 Cold Start Loader for CP/M 2. 
Version 2.0 August, 1979 



false 


equ 





true 


equ 


not false 


testing 


equ 


false 


/ 


if 


testing 


bias 


equ 
endif 


03400h 




if 


not testing 


bias 


equ 
endif 


0000h 


cpmb 


equ 


bias 


bdos 


equ 


806h+bias 


bdose 


equ 


1880h+bias 


boot 


equ 


1600h+bias 


rboot 


equ 


boot+3 



bdosl 
ntrks 
bdoss 
bdos0 
bdosl 

mon80 

rmon8£ 

base 

rtype 

rbyte 

reset 

dstat 

ilow 

ihigh 

bsw 

recal 

readf 

stack 



org 

equ 
equ 
equ 
equ 

eau 

equ 
equ 
equ 
equ 
equ 
equ 

equ 
equ 
equ 
equ 
equ 
equ 
equ 



3000h 



;base of dos load 

; entry to dos for calls 

;end of dos load 

;cold start entry point 

;warm start entry point 



;loaded here by hardware 



bdose-cpmb 

2 

bdosl/128 

25 

bdoss-bdos0 



tracks to read 

# sectors in bdos 

# on track 

# on track 1 



0f800h 

0ff0fh 

7 8h 

base+1 

base+3 

base+7 

base 

base+1 

base+2 

0f fh 

3h 

4h 

100h 



intel monitor base 
restart location for mon80 
'base' used by controller 
result type 
result byte 
reset controller 

disk status port 

low iopb address 

high iopb address 

boot switch 

recalibrate selected drive 

disk read function 

use end of boot for stack 



3000 310001 



3003 
3005 



db7 
db7 



3007 dbff 

mho 



r start: 

lxi 

; clear 
in 
in 

; check 

colds tart: 
in 
ani 



sp, stack; in case of call to mon80 
disk status 

rtype 

rbyte 
if boot switch is off 

bsw 

02b-, ,_ :switch on? 
coidstart 
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300e d37f 



clear the controller 

out reset ;logic cleared 



3010 0602 
3012 214230 



mvi b,ntrks ;number of tracks to read 
lxi h,iopb0 



start: 



3015 7d 

3016 d379 

3018 7c 

3019 d37a 

301b db78 

301d e604, fl 

301r calb30 



3022 db79 
3024 e603 
3026 fe02 



wait0 



3028 d20030 



read first/next track into cpmb 

mov a,l 

out ilow 

mov a,h 

out inigh 

in dstat 



am 



4 . 
wait0 



check disk status 



in 

ani 

cpi 

if 

cnc 

endif 

if 

jnc 

endif 



rtype 

lib 

2 

testing 

rmon80 ;go to monitor if 11 or 10 

not testing 

rstart ;retry the load 



302b 


db7b 


in 




i 


if no 


302d 


17 


ral 


302e 


dc0fff 


cc 


3031 


If 


rar 


3032 


e61e 


ani 




? 


if 
cnz 
endif 
if 


3034 


C20030 


jnz 




} 


endif 
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110700 


lxi 


303a 


19 


dad 


303b 


5 


dcr 


303c 


C21530 


jnz 

jmp b 



303f C30016 



rbyte ; i/o complete, check status 
if not ready, then go to mon80 

rmon80 ;not ready bit set 

; restore 
11110b ;overrun/addr err/seek/crc 

testing 

rmon80 ;go to monitor 

not testing 

rstart ;retry the load 



d r iopbl ; length of iopb 

d ; addressing next iopb 

b ;count down tracks 

start 



jmp boot, print message, set-up jmps 
jmp boot 



parameter blocks 
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3042 


80 


iopb0 : 


db 


80h 


3043 


04 




db 


readf 


3044 


19 




db 


bdos0 


3045 


00 




db 





3046 


02 




db 


2 


3047 


0000 




dw 


cpmb 


0007 


= 


iopbl 


equ 


$-iop 


3049 


80 


r 

iopbl : 


db 


80h 


304a 


04 




db 


readf 


304b 


18 




db 


bdosl 


304c 


01 




db 


1 


304d 


01 




db 


1 


304e 


800c 




dw 


cpmb+ 


3050 






end 





iocw, no update 

read function 

# sectors to read trk 

track 

start with sector 2, trk 

start at base of bdos 



jsectors to read on track 1 

; track 1 

;sector 1 

is0*128 ;base of second rd 
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APPENDIX B: THE MDS BASIC I/O SYSTEM (BIOS) 



0014 = 



4a00 
3400 
3c06 
1600 
2c 
0002 
0004 
0080 
000a 



vers 



cpmb 

bdos 

cpml 

nsects 

offset 

cdisk 

buff 

retry 



mds-800 i/o drivers for cp/m 2.0 
(four drive single density version) 

version 2.0 august, 1979 

equ 20 ;version 2.0 

copyright (c) 1979 
digital research 
box 579, pacific grove 
California, 93950 



org 
equ 
equ 
equ 
equ 
equ 
equ 
equ 
equ 

perform 
boot 
wboot 
(boot a 
const 



conin 

conout 

list 

punch 

reader 

home 



4a00h 

3400h 

3c06h 

$-cpmb 

cpml/128 

2 

0004h 

0080h 

10 



base of bios in 20k system 

base of cpm ccp 

base of bdos in 20k system 

length (in bytes) of cpm system 

number of sectors to load 

number of disk tracks used by cp 

address of last logged disk 

default buffer address 

max retries on disk i/o before e 



following functions 
cold start 

warm start (save i/o byte) 
nd wboot are the same for mds) 
console status 

reg-a = 00 if no character ready 
reg-a = ff if character ready 
console character in (result in reg-a) 
console character out (char in reg-c) 
list out (char in reg-c) 
punch out (char in reg-c) 
paper tape reader in (result to reg-a) 
move to track 00 









jump 


vector for 


4a00 


c3b34a 




J m P 


boot 


4a03 


c3c34a 


wboote: 


jmp 


wboot 


4a06 


c3614b 




jmp 


const 


4a09 


c3644b 




jmp 


conin 


4a0c 


c36a4b 




jmp 


conout 



(the following calls set-up the io parameter bloc 
mds, which is used to perform subsequent reads an 
seldsk select disk given by reg-c (0,1,2...) 
settrk set track address (0,...76) for sub r/w 
setsec set sector address (1 ,... ,26) 
setdma set subsequent dma address (initially 80h 

read/write assume previous calls to set i/o parms 
read read track/sector to preset dma address 
write write track/sector from preset dma addres 



indiviual routines 
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4a0f 
4al2 
4al5 
4al8 
4alb 
4ale 
4a21 
4a24 
4a27 
4a2a 
4a2d 
4a30 



c36d4b 
c3724b 
c3754b 
c3784b 
c37d4b 
c3a74b 
c3ac4b 
c3bb4b 
c3cl4b 
c3ca4b 
c3704b 
c3bl4b 



4a33+= dpbase 

4a33+824a00 dpe0 : 

4a37+000000 

4a3b+6e4c73 

4a3f+0d4dee 

4a43+824a00 dpel : 

4a47+000000 

4a4b+6e4c73 

4a4f+3c4dld 

4a53+824a00 dpe2 : 

4a57+000000 

4a5b+6e4c73 

4a5f+6b4d4c 

4a63+824a00 dpe3 : 

4a67+000000 

4a6b+6e4c73 

4a6f+9a4d7b 



4a73+= 

4a73+la00 

4a75+03 

4a76+07 

4a77+00 

4a78+f200 

4a7a+3f00 

4a7c+c0 

4a7d+00 

4a7e+1000 

4a80+0200 

4a82+= 

4a82+01 

4a83+07 

4a84+0d 

4a85+13 

4a86+19 

4a87+05 

4a88+0b 

4a89+ll 

4a8a+17 

4a8b+03 



dpb0 



xlt! 



jmp 
jmp 
jmp 
jmp 
jmp 
jmp 
jmp 
jmp 
jmp 
jmp 
jmp 
jmp 

maclib 

disks 

equ 

dw 

dw 

dw 

dw 

dw 

dw 

dw 

dw 

dw 

dw 

dw 

dw 

dw 

dw 

dw 

dw 

d i s kd e f 

equ 

dw 

db 

db 

db 

dw 

dw 

db 

db 

dw 

dw 

equ 

db 

db 

db 

db 

db 

db 

db 

db 

db 

db 



list 

punch 

reader 

home 

seldsk 

settrk 

setsec 

setdma 

read 

write 

listst 

sectran 



;list status 



diskde 
4 

$ 

xlt0,0 

0000h, 

d i r bu f 

csv0 ,a 

xltl,0 

0000h, 

d i r bu f 

csvl ,a 

xlt2 r 

0000h, 

d i r bu f 

csv2 ,a 

xlt3,0 

0000h, 

d i r bu f 

csv3 r a 

0,1,26 

$ 

26 

3 

7 



242 

6 3 

192 



16 

2 

$ 

1 

7 

13 

19 

25 

5 

11 

17 

23 

3 



f ;load the disk definition library 
; f our disks 

;base of disk parameter blocks 
000h /translate table 
0000h ;scratch area 
f dpb0 ;dir buff r parm block 
lv0 ;check, alloc vectors 
000h /translate table 
0000h ;scratch area 
,dpbl ;dir buff f parm block 
lvi ;check f alloc vectors 
000h ;translate table 
0000h ;scratch area 
f dpb2 ;dir buff f parm block 
lv2 ;check r alloc vectors 
000h /translate table 
0000h ;scratch area 
r dpb3 ;dir buff r parm block 
lv3 ;check r alloc vectors 
r 6 r 10 24 r 243 r 64 r 64 r offset 

disk parm block 

sec per track 

block shift 

block mask 

extnt mask 

disk size-1 

directory max 

alloc0 

allocl 

check size 

offset 

translate table 
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4a8c+09 
4a8d+0f 
4a8e+15 
4a8f+02 
4a90+08 
4a91+0e 
4a92+14 
4a93+la 
4a94+06 
4a95+0c 
4a96+12 
4a97+18 
4a98+04 
4a99+0a 
4a9a+10 
4a9b+16 

4a73+= 
001f+= 
0010+= 
4a82+= 

4a73+= 
001f+= 
0010+= 
4a82+= 

4a73+= 
001f+= 
0010+= 
4a82+= 



00fd 
00fc 
00f3 
007e 



f800 
ff0f 
f803 
f806 
f809 
f80c 
f80f 
f812 





db 




9 




db 




15 




db 
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db 




2 




db 




8 




db 




14 




db 




20 




db 




26 




db 




6 




db 




12 




db 




18 




db 




24 




db 




4 




db 




10 




db 




16 




db 




22 




d i s kd e 


f 


1,0 


dpbl 


equ 




dpb0 


alsl 


egu 




als0 


cssl 


equ 




CSS0 


xltl 


equ 




xlt0 




d i s kd e 


f 


2 r 


dpb2 


equ 




dpb0 


als2 


equ 




als0 


css2 


equ 




css0 


xlt2 


equ 




xlt0 




d i s kd e 


f 


3,0 


dpb3 


equ 




dpb0 


als3 


equ 




als0 


css3 


equ 




CSS0 


xlt3 


equ 




Xlt0 




endef 


occurs 



revr t 
intc 
icon 
inte 



mon80 

rmon80 

ci 

r i 

co 

po 

lo 

csts 



equivalent parameters 
;same allocation vector size 
;same checksum vector size 
;same translate table 

equivalent parameters 
;same allocation vector size 
;same checksum vector size 
;same translate table 

equivalent parameters 
;same allocation vector size 
;same checksum vector size 
;same translate table 
at end of assembly 



end of controller - independent code, the remaini 
are tailored to the particular operating environm 
be altered for any system which differs from the 

the following code assumes the mds monitor exists 
and uses the i/o subroutines within the monitor 

we also assume the mds system has four disk drive 

equ 0fdh ; interrupt revert port 

equ 0fch ; interrupt mask port 

equ 0f3h ; interrupt control port 

equ 0111$1110b;enable rst (warm boot) ,rst 7 



mds monitor equates 



equ 
equ 
equ 
equ 
equ 
equ 
equ 
equ 



0f800h 
0ff0fh 
0f803h 
0f806h 
0f809h 
0f80ch 
0f80fh 
0f812h 



mds monitor 

restart mon80 (boot error) 

console character to reg-a 

reader in to reg-a 

console char from c to console o 

punch char from c to punch devic 

list from c to list device 

console status 00/ff to register 
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disk ports and commands 



0078 


= 


base 


equ 


0078 


= 


dstat 


equ 


0079 


= 


rtype 


equ 


007b 


= 


rbyte 

• 


equ 


0079 


= 


ilow 


equ 


007a 


= 


ihigh 


equ 


0004 


= 


readf 


equ 


0006 


= 


wr itf 


equ 


0003 


= 


recal 


equ 


0004 


= 


iordy 


equ 


000d 


= 


cr 


equ 


000a 


= 


If 


equ 






signon: 


; si< 


4a9c 


0d0a0a 




db 


4a9f 


3230 




db 


4aal 


6b2043f 


db 


4aad 


322e30 




db 


4ab0 


0d0a00 




db 



78h 
base 
base+1 
base+3 

base+1 
base+2 

4h 

6h 

3h 

4h 

0dh 

0ah 



base of disk command io ports 
disk status (input) 
result type (input) 
result byte (input) 

iopb low address (output) 
iopb high address (output) 

read function 
write function 
recalibrate drive 
i/o finished mask 
carriage return 
line feed 



; signon message: xxk cp/m vers y.y 
cr,lf ,lf 

'20' ; sample memory size 
' k cp/m vers ' 

vers/10+ , 0' , ' . ' ,vers mod 10+'0' 
cr,lf,0 



boot: ;print signon message and go to ccp 
; (note: mds boot initialized iobyte at 0003h) 

sp,buff+80h 
h, signon 

prmsg ;print message 
a ;clear accumulator 
cdisk ;set initially to disk a 
gocpm ;go to cp/m 



4ab3 


310001 


lxi 


4ab6 


219c4a 


lxi 


4ab9 


cdd34b 


call 


4abc 


af 


xra 


4abd 


320400 


sta 


4ac0 


c30f4b 


jmp 



4ac3 318000 



wboot: ; loader on track r sector l r which will be skippe 
; read cp/m from disk - assuming there is a 128 byt 
; start. 



lxi 



sp,buff ;using dma - thus 80 thru ff ok f 



4ac6 


0e0a 


mvi 


4ac8 


c5 


push 




wboot0 : 


; ent 


4ac9 


010034 


lxi 


4acc 


cdbb4b 


call 


4acf 


0e00 


mvi 


4adl 


cd7d4b 


call 


4ad4 


0e00 


mvi 


4ad6 


cda74b 


call 


4ad9 


0e02 


mvi 


4adb 


cdac4b 


call 



c r retry ;max retries 
b 
;enter here on error retries 

b,cpmb ;set dma address to start of disk 

setdma 

c r ;boot from drive 

seldsk 

c,0 

settrk ;start with track 

c r 2 ;start reading sector 2 

setsec 



4ade cl 
4adf 062c 



read sectors, count nsects to zero 
pop b ;10-error count 
mvi b r nsects 
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rdsec 



4ael 


c5 


4ae2 


cdcl4b 


4ae5 


c2494b 


4ae8 


2a6c4c 


4aeb 


118000 


4aee 


19 


4aef 


44 


4af0 


4d 


4afl 


cdbb4b 


4af4 


3a6b4c 


4af7 


fela 


4af9 


da054b 


4afc 


3a6a4c 


4aff 


3c 


4b00 


4f 


4b01 


cda74b 


4b04 


af 


4b05 


3c 


4b06 


4f 


4b07 


cdac4b 


4b0a 


cl 


4b0b 


05 


4b0c 


c2el4a 



rdl: 



;read next sector 

push b ;save sector count 

booterr ;retry if errors occur 
; increment dma address 
;sector size 
; incremented dma address in hi 

; ready for call to set dma 

;sector number just read 
;read last sector? 



;get track to register a 

;ready for call 

;clear sector number 
;to next sector 
; ready for call 

; recall sector count 
;done? 



call 


read 


jnz 


booter 


lhld 


iod 


lxi 


d,128 


dad 


d 


mov 


b r h 


mov 


c,l 


call 


setdma 


Ida 


ios 


cpi 


26 


jc 


rdl 


must be 


sector 


Ida 


iot 


inr 


a 


mov 


c,a 


call 


settrk 


xra 


a 


inr 


a 


mov 


c, a 


call 


setsec 


pop 


b 


dcr 


b 


jnz 


rdsec 



; done with the load, reset default buffer address 
gocpm: ; (enter here from cold start boot) 
; enable rst0 and rst7 



4b0f 


f3 


di 








4bl0 


3el2 


mvi 


a,12h 


; initialize command 




4bl2 


d3fd 


out 


revr t 






4bl4 


af 


xra 


a 






4bl5 


d3fc 


out 


intc 


;cleared 




4bl7 


3e7e 


mvi 


a, inte 


;rst0 and rst7 bits on 




4bl9 


d3fc 


out 


intc 






4blb 


af 


xra 


a 






4blc 


d3f3 


out 


icon 


; interrupt control 






/ 
/ 


set default buff 


:er address to 80h 




4ble 


018000 


lxi 


b,buff 






4b21 


cdbb4b 


call 


setdma 










reset 


monitor en 


itry points 




4b24 


3ec3 


mvi 


a, jmp 






4b26 


320000 


sta 









4b29 


21034a 


lxi 


h,wboote 


i 




4b2c 


220100 


shld 


1 


;jmp wboot at location 00 




4b2f 


320500 


sta 


5 






4b32 


21063c 


lxi 


h r bdos 






4b35 


220600 


shld 


6 


;jmp bdos at location 5 




4b38 


323800 


sta 


7*8 


;jmp to mon80 (may have been 


chan 


4b3b 


2100f8 


lxi 


h,mon80 






4b3e 


223900 


shld 


7*8+1 







leave iobyte set 
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4b41 
4b44 
4b45 
4b46 



4b49 
4b4a 
4b4b 

4b4e 
4b4f 



3a0400 
4f 
fb 
C30034 



cl 
0d 
ca524b 

c5 
c3c94a 



booterr 



previously selected disk was b, send parameter to 
Ida cdisk ;last logged disk number 
mov c,a ;send to ccp to log it in 
ei 

jmp cpmb 

error condition occurred, print message and retry 



pop b 

dcr c 

jz booterl 

try again 

push b 

jmp wboot0 



; recall counts 



booter0 



4b52 
4b55 
4b58 



215b4b 
cdd34b 
c30fff 



otherwise too many retries 

lxi h,bootmsg 

call prmsg 

jmp rmon80 ;mds hardware monitor 



4b5b 3f626f4 



bootmsg 



db 



■?boot' ,0 



4b61 c312f8 



const: ;console status to reg-a 
; (exactly the same as mds call) 
jmp csts 



conin: ;console character to reg-a 

4b64 cd03f8 call ci 

4b67 e67f ani 7fh ;remove parity bit 

4b69 c9 ret 



4b6a c309f8 



4b6d c30ff8 



conout : 



list: 



listst: 



4b70 
4b71 



af 
c9 



4b72 c30cf8 



4b75 c306f8 



punch: 



reader: 



;console character from c to console out 
jmp co 

;list device out 

(exactly the same as mds call) 

jmp lo 



;return list status 

xra a 

ret ;always not ready 

;punch device out 

(exactly the same as mds call) 

jmp po 

; reader character in to reg-a 
(exactly the same as mds call) 
j mp r i 



home: ;move to home position 
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; treat as track 00 seek 

4b78 0e00 mvi c r 

4b7a c3a74b jmp settrk 

seldsk: ;select disk given by register c 

4b7d 210000 lxi h r 0000h ;return 0000 if error 

4b80 79 mov a,c 

4b81 fe04 cpi ndisks ;too large? 

4b83 d0 rnc ;leave hi = 0000 



4b84 e602 

4b86 32664c 

4b89 79 

4b8a e601 

4b8c b7 

4b8d ca924b 

4b90 3e30 



4b92 
4b93 
4b96 
4b97 
4b99 
4b9a 

im 

4b9e 
4b9f 
4ba0 
4bal 
4ba2 
4ba5 
4ba6 
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21684c 

7e 

e6cf 

b0 

77 

29 

29 

29 

29 

11334a 

19 

c9 



am 

sta 

mov 

ani 

ora 

jz 

mvi 

setdr ive : 

mov 

lxi 

mov 

ani 

ora 

mov 

mov 
mvi 

dad 

dad 

dad 

dad 

lxi 

dad 

ret 



10b 

dbank 

a, c 

lb 

a 

setdr ive 

a, 00110000b 



;00 00 for drive 0,1 and 10 10 fo 

; to select drive bank 

;00, 01, 10, 11 

;mds has 0,1 at 78, 2,3 at 88 

;result 00? 



; selects drive 1 in bank 



b,a 

h, iof 

a,m 

11001111b 

b 

m,a 

hi 

h 

h 

h 

h 

d ,dpbase 

d 



;save the function 
;io function 

;mask out disk number 
mask in new disk number 
save it in iopb 

hl=disk number 

*2 
* 4 

*8 
*16 

hl=disk header table address 



4ba7 216a4c 
4baa 71 
4bab c9 



settrk: ;set track address given by c 



lxi 
mov 
ret 



h, iot 
m,c 



4bac 216b4c 
4baf 71 
4bb0 c9 



4bbl 0600 

4bb3 eb 

4bb4 09 

4bb5 7e 

4bb6 326b4c 



setsec: ;set sector number given by c 



lxi 
mov 
ret 



sectran: 



Dba c 



mvi 

xchg 

dad 

mov 

sta 

mov 
ret 



h,ios 
m,c 

? translate sector be using table at de 



b,0 

b 

a,m 
ios 
Ira 



;double precision sector number i 
; translate table address to hi 
; translate (sector) address 
; translated sector number to a 

;return sector number in 1 



setdma: ;set dma address given by regs b,c 
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4bbb 


69 


4bbc 


60 


4bbd 


226c4c 


4bc0 


c9 


4bcl 


0e04 


4bc3 


cde04b 


4bc6 


cdf 04b 


4bc9 


c9 



mov 
mov 
shld 
ret 



lrC 

h r b 
iod 



read: ;read next disk record (assuming disk/trk/sec/dma 
mvi c r readf ;set to read function 
call setfunc 

call waitio ;perform read function 
ret ;may have error set in reg-a 



write: ;disk write function 



4bca 


0e06 


mvi 


4bcc 


cde04b 


call 


4bcf 


cdf04b 


call 


4bd2 


c9 


ret 



4bd3 7e 
4bd4 b7 
4bd5 c8 



4bd6 
4bd7 
4bd8 
4bdb 
4bdc 
4bdd 



4be0 
4be3 
4be4 
4be6 
4be7 



4be8 
4bea 
4bed 
4bee 
4bef 



e5 

4f 

cd6a4b 

el 

23 

c3d34b 



21684c 

7e 

e6f8 

bl 

77 



e620 

216b4c 

b6 

77 

c9 



prmsg 



setfunc 



c,wr itf 

setfunc ;set to write function 

waitio 

;may have error set 



utility subroutines 

;print message at h,l to 

mov a r m 

ora a ;zero? 

rz 

more to print 

push h 

mov c,a 

call conout 

pop h 

inx h 

jmp prmsg 



set function for next i/o (command in reg-c) 

lxi h,iof ;io function address 

mov a r m ;get it to accumulator for maskin 

ani 11111000b ; remove previous command 

ora c ;set to new command 

mov m r a ;replaced in iopb 

the mds-800 controller req's disk bank bit in sec 

mask the bit from the current i/o function 

ani 00100000b ;mask the disk select bit 

lxi h r ios ;address the sector selec 

ora m ;select proper disk bank 

mov m,a ;set disk select bit on/o 

ret 



4bf0 0e0a 



4bf2 cd3f4c 
4bf5 cd4c4c 

4bf8 3a664c 



waitio: 



rewait: 



mvi 



c, retry ;max retries before perm error 



start the i/o function and wait for completion 

call intype ; in rtype 

call inbyte ;clears the controller 



Ida 



dbank 



;set bank flags 



46 



4bfb 


b7 


4bfc 


3e67 


4bfe 


064c 


4c00 


c20b4c 


4c03 


d379 


4c05 


78 


4c06 


d37a 


4c08 


c3104g 


4c0b 


d389 


4c0d 


78 


4c0e 


d38a 



4cl0 cd594c wait0 
4cl3 e604 
4cl5 cal04c 



4cl8 cd3f4c 



4clb fe02 
4cld ca324c 



4c20 b7 
4c21 c2384c 



4c24 cd4c4c 
4c27 17 
4c28 da324c 
4c2b If 
4c2c e6fe 
4c2e c2384c 



4c31 c9 



ora a jzero if drive 0,1 and nz 

mvi a, iopb and 0ffh ;low address for iopb 

mvi b, iopb shr 8 ;high address for iopb 

jnz iodrl ;drive bank 1? 

out ilow ;low address to controlle 

mov a f b 

out ihigh ;high address 

jmp wait0 



iodrl: ; drive bank 1 



4c32 cd4c4c 
4c35 c3384c 



wready 



werror 



out 
mov 
out 

call 

ani 

jz 



ilow+10h 
a f b 
ihigh+10h 

instat 

iordy 

wait0 



;to wait for complete 
;88 for drive bank 10 



;wait for completion 
;ready? 



check io completion ok 

call intype ;must be io complete (00) 

00 unlinked i/o complete, 01 linked i/o comple 

10 disk status changed 11 (not used) 

cpi 10b ;ready status change? 

jz wready 

must be 00 in the accumulator 

ora a 

jnz werror ; some other condition, re 



check i/o error bits 

call inbyte 

ral 

jc wready 

rar 

ani 11111110b 

jnz werror 



;unit not ready 
;any other errors? 



read or write is ok, accumulator contains zero 
ret 

;not ready, treat as error for now 

call inbyte ;clear result byte 

jmp trycount 

;return hardware malfunction (crc, track, seek, e 
the mds controller has returned a bit in each pos 
of the accumulator, corresponding to the conditio 

- deleted data (accepted as ok above) 

1 .- crc error 

2 - seek error 

3 - address error (hardware malfunction) 

4 - data over/under flow (hardware malfunct 

5 - write protect (treated as not ready) 

6 - write error (hardware malfunction) 

7 - not ready 
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(accumulator bits are numbered 76543210) 



4c38 
4c39 



0d 
c2f24b 



; it may be useful to filter out the various condit 

; but we will get a permanent error message if it i 

; recoverable. in any case, the not ready conditio 

; treated as a separate condition for later improve 

trycount: 

; register c contains retry count, decrement 'til z 

dcr c 

jnz rewait ;for another try 



4c3c 
4c3e 



3e01 
c9 



cannot recover from error 
mvi a r l ;error code 
ret 



4c3f 
4c42 
4c43 
4c46 
4c48 
4c49 
4c4b 



3a664c 

b7 

c2494c 

db79 

c9 

db89 

c9 



; intype r inbyte, instat read drive bank 00 or l.i 
intype: Ida dbank 

a 

intypl ?skip to bank 10 

rtype 



ora 
jnz 
in 
ret 
intypl: in 
ret 



rtype+10h 



;78 for r l 88 for 2,3 



4c4c 
4c4f 
4c50 
4c53 
4c55 
4c56 
4c58 



3a664c 

b7 

c2564c 

db7b 

C9 

db8b 

c9 



inbyte: Ida 
ora 
jnz 
in 
ret 

inbytl: in 
ret 



dbank 
a 

inbytl 
rbyte 

rbyte+10h 



4c59 
4c5c 
4c5d 
4c60 
4c62 
4c63 
4c65 



3a664c 

b7 

c2634c 

db78 

c9 

db88 

c9 



instat: Ida 
ora 
jnz 
in 
ret 

instal: in 
ret 



4c66 


00 


dba 
iop 


4c67 


80 




4c68 


04 


iof 


4C69 


01 


ion 


4c6a 


02 


iot 


4c6b 


01 


ios 


4c6c 


8000 


iod 



dbank 
a 

instal 
dstat 

dstat+10h 



data areas (must be in ram) 
db ;disk bank 00 

; 10 

;io parameter block 



if drive 
if drive 



0,1 
2,3 



db 
db 
db 
db 
db 
dw 



80h ;normal i/o operation 

readf ; io function, initial 

1 ; number of sectors to 

offset ; track number 

1 ; sector number 

buff ;io address 



read 
read 



define ram areas for bdos operation 
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endef 




4c6e+= 


begdat 


equ 


$ 


4c6e+ 


d i r bu f : 


ds 


128 ;directory access buffer 


4cee+ 


alv0 : 


ds 


31 


4d0d+ 


csv0 : 


ds 


16 


4dld+ 


alvl: 


ds 


31 


4d3c+ 


csvl: 


ds 


16 


4d4c+ 


alv2: 


ds 


31 


4d6b+ 


csv2: 


ds 


16 


4d7b+ 


alv3: 


ds 


31 


4d9a+ 


csv3 : 


ds 


16 


4daa+= 


enddat 


equ 


$ 


013c+= 


datsiz 


equ 


$-begdat 


4daa 




end 
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APPENDIX C: A SKELETAL CBIOS 



0014 = 



msize 



0000 
3 40 
3c06 
4a00 
0004 
0003 

4a00 
002c 



4a00 
4a03 
4a06 
4a09 
4a0c 
4a0f 
4al2 
4al5 
4al8 
4alb 
4ale 
4a21 
4a24 
4a27 
4a2a 
4a2d 
4a30 



c39c4a 
c3a64a 
c3114b 
c3244b 
c3374b 
c3494b 
c34d4b 
c34f4b 
c3544b 
c35a4b 
c37d4b 
c3924b 
c3ad4b 
c3c34b 
c3d64b 
c34b4b 
c3a74b 



bias 

ccp 

bdos 

bios 

cdisk 

iobyte 



nsects 



wboote 



4a33 734a00 dpbase 
4a37 000000 
4a3b f04c8d . 
4a3f ec4d70 

4a43 734a00 
4a47 000000 
4a4b f04c8d 
4a4f fc4d8f 

4a53 734a00 
4a57 000000 
4a5b f04c8d 
4a5f 0c4eae 



skeletal cbios for first level of cp/m 2.0 altera 

equ 20 ; cp/m version memory size in kilo 

"bias" is address offset from 3400h for memory sy 
than 16k (referred to as "b" throughout the text) 



equ 
equ 
equ 
equ 
equ 
equ 

org 
equ 

jump 

jmp 

jmp 

jmp 

jmp 

jmp 

jmp 
jmp 
jmp 
jmp 
jmp 
jmp 
jmp 
jmp 
jmp 
jmp 
jmp 
jmp 



(msize-20) *1024 
3400h+bias 
ccp+806h 
ccp+1600h 



;base of ccp 
;base of bdos 
;base of bios 



0004h ;current disk number 0=a,...,15=p 
0003h ;intel i/o byte 

bios ; origin of this program 
($-ccp)/128 ;warm start sector count 



vector for 
boot 
wboot 
const 
conin 
conout 
list 
punch 
reader 
home 
seldsk 
settrk 
setsec 
setdma 
read 
wr ite 
listst 
sectran 



individual subroutines 
cold start 
warm start 
console status 
console character in 
console character out 
list character out 
punch character out 
reader character out 
move head to home positi 
select disk 
set track number 
set sector number 
set dma address 
read disk 
write disk 
return list status 
sector translate 



par 



fixed da 

ibm-comp 

disk par 

dw 

dw 

dw 

dw 

disk 

dw 

dw 

dw 

dw 

disk 

dw 

dw 

dw 

dw 



par 



ta tables for four-drive standard 

atible 8" disks 

ameter header for disk 00 

trans f 0000h 

0000h r 0000h 

dirbf f dpblk 

chk00 r all00 

ameter header for disk 01 

trans, 0000h 

0000h,0000h 

dirbf r dpblk 

chk01 r all01 

ameter header for disk 02 

trans r 0000h 

0000h r 0000h 

dirbf f dpblk 

chk02 f all02 
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i 


disk p 


arameter header for disk 03 


4a63 


734a00 




dw 


trans, 0000h 




4a67 


000000 




dw 


0000h,0000h 




4a6b 


f04c8d 




dw 


dirbf ,dpblk 




4a6f 


lc4ecd 




dw 


chk03,all03 








t 
t 


sector 


translate vector 




aw mm 


trans: 


^ 


W,s)h}h 


•sectors 1,2,3,4 
■sectors 5,5,7,8 


4a7b 


170309 




db 


23,3,9,15 


^sectors 9,10,11,12 


4a7f 


150208 




db 


21,2,8,14 


•sectors 13,14,15,16 


4a83 


141a06 




db 


20,26,6,12 


•sectors 17,18,19,20 


4a87 


121804 




db 


18,24,4,10 ; 


sectors 21,22,23,24 


4a8b 


1016 




db 


16,22 


•sectors 25,26 






dpblk: 


; disk 


parameter block, common to all disks 


4a8d 


la00 




dw 


26 


•sectors per track 


4a8f 


03 




db 


3 ; 


block shift factor 


4a90 


07 




db 


7 ; 


block mask 


4a91 


00 




db 


; 


•null mask 


4a92 


f200 




dw 


242 ; 


•disk size-1 


4a94 


3f00 




dw 


63 


•directory max 


4a96 


C0 




db 


192 


•alloc 


4a97 


00 




db 





•alloc 1 


4a98 


1000 




dw 


16 


•check size 


4a9a 


0200 




dw 


2 


;track offset 



4a9c 
4a9d 
4aa0 
4aa3 

4aa6 
4aa9 
4aab 
4aae 



af 

320300 
320400 
c3ef4a 

318000 
0e00 
cd5a4b 
cd544b 



boot: 



wboot 



end of fixed tables 

individual subroutines to perform each function 
;simplest case is to just perform parameter initi 

;zero in the accum 
;clear the iobyte 
;select disk zero 
;initialize and go to cp/ 



xra 
sta 
sta 
jmp 



a 

i o by t e 

cdisk 

gocpm 



; simplest case 
lxi sp,80h 
mvi c,0 
call seldsk 
call home 



is to read the disk until 
;use space below 
;select disk 

;go to track 00 



all sect 
buffer f 



4abl 062c 
4ab3 0e00 
4ab5 1602 



4ab7 210034 



4aba 
4abb 
4abc 
4abd 
4abe 
4acl 



c5 

d5 

e5 

4a 

cd924b 

cl 



loadl 



mvi 
mvi 
mvi 
note 
Izonta 
lxi 
; load 
push 
push 
push 
mov 
call 
pop 



b,nsects ;b counts 

c,0 ;c has th 

d,2 ;d has th 

that we begin by reading tra 

ins the cold start loader, w 

h,ccp ;base of 

one more sector 



# of sec 
e current 
e next se 
ck , sec 
hich is s 
cp/m (ini 



tors to 

track 
ctor to 
tor 2 s 
kipped 
tial lo 



b 

d 

h 

c ,d 

setsec 

b 



save sector coun 
save next sector 
save dma address 
get sector addre 
set sector addre 
recall dma addre 



t, current track 
to read 



ss to reg 
s s f r om r 
ss to b,c 



ister c 
egister 
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4ac2 c5 
4ac3 cdad4b 



4ac6 cdc34b 
4ac9 fe00 
4acb c2a64a 



4ace el 

4acf 118000 

4ad2 19 

4ad3 dl 

4ad4 cl 

4ad5 05 

4ad6 caef4a 



push b ; replace on stack for later recal 

call setdma ;set dma address from b,c 

drive set to 0, track set, sector set, dma addres 

call read 

cpi 00h ;any errors? 

jnz wboot ;retry the entire boot if an erro 

no error, move to next sector 



pop 
lxi 
dad 
pop 
pop 
dcr 
jz 



h 

d,128 

d 

d 

b 

b 

gocpm 



recall dma address 

dma=dma+128 

new dma address is in h,l 

recall sector address 

recall number of sectors remaini 

sectors=sectors-l 

transfer to cp/m if all have bee 



4ad9 14 
4ada 7a 
4adb felb 
4add daba4a 



4ae0 1601 
4ae2 0c 



4ae3 c5 
4ae4 d5 
4ae5 e5 
4ae6 cd7d4b 
4ae9 el 
4aea dl 
4aeb cl 
4aec c3ba4a 



gocpm 



4aef 


3ec3 


mvi 


a,0c3h 


4afl 


320000 


sta 





4af4 


21034a 


lxi 


h,wboo 


4af7 


220100 


shld 


1 


4af a 


320500 


sta 


5 


4afd 


21063c 


lxi 


h,bdos 


4b00 


220600 


shld 


6 


4b03 


018000 


lxi 


b,80h 


4b06 


cdad4b 


call 


setdma 


4b09 


fb 


ei 




4b0a 


3a0400 


Ida 


cdisk 


4b0d 


4f 


mov 


c,a 


4b0e 


C30034 


jmp 


ccp 



more sectors remain to load, check for track chan 

inr d 

mov a,d ;sector=27?, if so, change tracks 

cpi 27 

jc loadl ;carry generated if sector<27 

end of current track, go to next track 

mvi d,l ;begin with first sector of next 

inr c ; track=track+l 

save register state, and change tracks 

push b 

push d 

push h 

call settrk ;track address set from register 

pop h 

pop d 

pop b 

jmp loadl ;for another sector 

end of load operation, set parameters and go to c 



a,0c3h ;c3 is a jmp instruction 
; for jmp to wboot 

;wboot entry point 
;set address field for jmp at 

;for jmp to bdos 
h,bdos ;bdos entry point 

;address field of jump at 5 to bd 



;default dma address is 80h 



;enable the interrupt system 

;get current disk number 

;send to the ccp 

;go to cp/m for further processin 
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4bll 

4b21 3e00 
4b23 c9 



const: 



simple i/o handlers (must be filled in by user) 
in each case, the entry point is provided, with s 
to insert your own code 

;console status, return 0ffh if character ready, 
ds 10h ;space for status subroutine 
mvi a,00h 
ret 



conin: ;console character into register a 

4b24 ds 10h ;space for input routine 

4b34 e67f ani 7fh ;strip parity bit 

4b36 c9 ret 

conout: ;console character output from register c 

4b37 79 mov a,c ;get to accumulator 

4b38 ds 10h ;space for output routine 

4b48 c9 ret 



4b49 79 
4b4a c9 



4b4b af 
4b4c c9 



list: ;list character from register c 

mov a,c ;character to register a 
ret ;null subroutine 

listst: ;return list status (0 if not ready, 1 if ready) 
xra a ;0 is always ok to return 
ret 



punch: ;punch character from register c 
4b4d 79 mov a,c ;character to register a 

4b4e c9 ret ;null subroutine 



4b4f 3ela 
4b51 e67f 
4b53 c9 



4b54 0e00 
4b56 cd7d4b 
4b59 c9 



reader: ;read character into register a from reader devic 

mvi a,lah ;enter end of file for now (repla 

ani 7fh ;remember to strip parity bit 
ret 



i/o drivers for the disk follow 

for now, we will simply store the parameters away 

in the read and write subroutines 

home: ;move to the track 00 position of current drive 
; translate this call into a settrk call with param 

mvi c,0 ;select track 

call settrk 

ret ;we will move to 00 on first read 



seldsk: ;select disk given by register c 

4b5a 210000 lxi h,0000h ;error return code 

4b5d 79 mov a,c 

4b5e 32ef4c sta diskno 

4b61 fe04 cpi 4 ;must be between and 3 
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4b63 d0 
4b64 



4b6e 
4b71 
4b72 
4b74 
4b75 
4b76 
4b77 
4b78 
4b7b 
4b7c 



3aef4c 

6f 

2600 

29 

29 

29 

29 

11334a 

19 

c9 



rnc ;no carry if 4,5,... 

disk number is in the proper range 

ds 10 ;space for disk select 

compute proper disk parameter header address 

Ida 

mov 

mvi 

dad 

dad 

dad 

dad 

lxi 

dad 

ret 



diskno 




l,a 


;l=disk number 0,1,2,3 


h r 


;high order zero 


h 


;*2 


h 


;*4 


h 


;*8 


h 


;*16 (size of each header) 


d, dpbase 



; hi =. dpbase (diskno*! 6) 



4b7d 
4b7e 
4b81 
4b91 



79 
32e94c 

c9 



settrk: ;set track given by register c 



mov 
sta 
ds 
ret 



a,c 

track 

10h ;space for track select 



4b92 
4b93 
4b96 
4ba6 c9 



79 
32eb4c 



setsec: ;set sector given by register c 



mov 
sta 
ds 
ret 



a,c 

sector 

10h ;space for sector select 



sectran: 



4ba7 
4ba8 
4ba9 
4baa 
4bac 



eb 

09 

6e 

2600 

c9 



;translate the sector given by be using the 
;translate table given by de 



xchg 

dad 

mov 

mvi 

ret 



b 

1 ,m 
h,0 



hl=. trans 
hi =. trans (sector) 
1 = trans (sector) 
hl= trans (sector ) 
with value in hi 



4bad 69 
4bae 60 
4baf 22ed4c 
4bb2 
4bc2 c9 



setdma: ;set dma address given by registers b and c 



mov 

mov 

shld 

ds 

ret 



l,c ;low order address 

h,b ;high order address 

dmaad ;save the address 

10h ; space for setting the dma addres 



4bc3 

4bd3 c3e64b 



4bd6 



read: ;perform read operation (usually this is similar 
; so we will allow space to set up read command, th 
; common code in write) 

ds 10h ;set up read command 

jmp waitio ; to perform the actual i/o 

write: ;perform a write operation 

ds 10h ;set up write commanu 

waitio: ;enter here from read and write to perform the ac 
; operation. return a 00h in register a if the ope 
; properly, and 01h if an error occurs during the r 
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4be6 

4ce6 3e01 
4ce8 c9 



4ce9 


track: 


ds 


2 


4ceb 


sector: 


ds 


2 


4ced 


dmaad: 


ds 


2 


4cef 


diskno: 


ds 


1 




• 


scratch 


ram 


4cf0 = 


begdat 


equ 


$ 


4cf0 


dirbf : 


ds 


128 


4d70 


all00: 


ds 


31 


4d8f 


a 1101: 


ds 


31 


4dae 


all02: 


ds 


31 


4dcd 


all03: 


ds 


31 


4dec 


chk00: 


ds 


16 


4dfc 


chk01: 


ds 


16 


4e0c 


chk02: 


ds 


16 


4elc 


chk03: 


ds 


16 


4e2c = 


7 

enddat 


equ 


$ 


013c = 


datsiz 


equ 


$-b 


4e2c 




end 





in this case, we have saved the disk number in 'd 

the track number in 'track* (0-76 
the sector number in 'sector' ti- 
the dma address in 'dmaad' (0-655 

ds 256 ; space reserved for i/o drivers 

mvi a,l ;error condition 

ret ;replaced when filled-in 

the remainder of the cbios is reserved uninitiali 
data area, and does not need to be a part of the 
system memory image (the space must be available, 
however, between "begdat" and "enddat"). 



; two bytes for expansion 
; two bytes for expansion 
;direct memory address 
;disk number 0-15 

l for bdos use 
beginning of data area 
scratch directory area 



allocation vector 
allocation vector 
allocation vector 

allocation vector 
check vector 
check vector 1 
check vector 2 
check vector 3 



;end of data area 
$-begdat;size of data area 
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0100 

0014 



APPENDIX D: A SKELETAL GETSYS/PUTSYS PROGRAM 

; combined getsys and putsys programs from Sec 4. 
; Start the programs at the base of the TPA 



msize 



org 
egu 



0100h 
20 



; size of cp/m in Kbytes 



; "bias" is the amount to add to addresses for > 20k 
; (referred to as M b" throughout the text) 



0000 = 


bias 


equ 


(msize-20) *1024 


3400 = 


ccp 


equ 


3400h+bias 


3c00 = 


bdos 


equ 


ccp+0800h 


4a00 = 


bios 


equ 


ccp+1600h 



getsys programs tracks and 1 to memory at 
3880h + bias 



0100 
0103 
0106 



318033 
218033 
0600 



0108 0e01 



gstart: 



rd$trk: 
rd$sec: 



register 
a 
b 
c 

d,e 
h,l 
sp 



usage 
(scratch register) 
track count (0...76) 
sector count (1...26) 
(scratch register pair) 
load address 
set to stack address 



lxi sp r ccp-0080h 

lxi h,ccp-0080h 

mvi b,0 

mvi c,l 



010a 


cd0003 


call 


read$sec 


010d 


118000 


lxi 


d,128 


0110 


19 


dad 


d 


0111 


0c 


inr 


c 


0112 


79 


mov 


a,c 


0113 


felb 


cpi 


27 


0115 


da0a01 


jc 


rdsec 



start of getsys 
convenient plac 
set initial loa 
start with trac 
read next track 
each track star 

get the next se 
offset by one s 

(hl=hl+128) 
next sector 
fetch sector nu 

and see if la 
<, do one more 



arrive here at end of track, move to next track 



0118 


04 


inr 


0119 


78 


mov 


011a 


fe02 


cpi 


011c 


da0801 


jc 




i 


arrive he 


011f 


fb 


ei 


0120 


76 


hit 



b 

a r b 
2 
rd$trk 



track = track+1 
check for last 
track = 2 ? 
<, do another 



at end of load, halt for lack of anything b 
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putsys program, places memory image starting at 

3880h + bias back to tracks and 1 

start this program at the next page boundary 



0200 



org 



($+0100h) and 0ff00h 







pu 


t?sys 


• 
• 




0200 


318033 






lxi 


sp r ccp-0080h 


0203 


218033 






lxi 


h,ccp-0080h 


0206 


0600 


wr 


$trk: 


mvi 


b,0 


0208 


0e01 


wr 


$sec: 


mvi 


c,l 


020a 


cd0004 






call 


wr ite$sec 


020d 


118000 






lxi 


d f 128 


0210 


19 






dad 


d 


0211 


0c 






inr 


c 


0212 


79 






mov 


a r c 


0213 


felb 






cpi 


27 


0215 


da0a02 






jc 


wr$sec 



convenient plac 
start of dump 
start with trac 

; start with sect 

write one secto 
length of each 
<hl>=<hl> + 128 
<c> = <c> + 1 
see if 

past end of t 
no, do another 



arrive here at end of track, move to next track 



0218 


04 


inr 


b 


0219 


78 


mov 


a,b 


021a 


fe02 


cpi 


2 


021c 


da0802 


jc 


wr$trk 



021f 
0220 



fb 
76 



track = track+1 
see if 

last track 
no, do another 



done with putsys, halt for lack of anything bette 



ei 
hit 



0300 



0300 c5 

0301 e5 



0302 

0342 el 

0343 cl 



; user supplied subroutines for sector read and write 

; move to next page boundary 

org ($+0100h) and 0ff00h 

read$sec 

read the next sector 
track in <b> , 
sector in <c> 
dmaaddr in <hl> 



push 
push 



; user defined read operation goes here 
ds 64 



pop 
pop 
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0344 c9 ret 

0400 org ($+0100h) and 0ff00h ; another page bo 
wr ite$sec: 

; same parameters as read$sec 

0400 c5 push b 

0401 e5 push h 

; user defined write operation goes here 

0402 ds 64 

442 el pop h 

443 cl pop b 

0444 c9 ret 

; end of getsys/putsys program 

0445 end 
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APPENDIX E: A SKELETAL COLD START LOADER 



this is a sample cold start loader which, when modified 
resides on track 00, sector 01 (the first sector on the 
diskette) . we assume that the controller has loaded 
this sector into memory upon system start-up (this pro- 
gram can be keyed-in, or can exist in read/only memory 
beyond the address space of the cp/m version you are 
running) . the cold start loader brings the cp/m system 
into memory at "loadp" (3400h + "bias"). in a 20k 
memory system, the value of "bias" is 0000h f with large 
values for increased memory sizes (see section 2). afte 
loading the cp/m system, the clod start loader branches 
to the "boot" entry point of the bios, which begins at 
"bios" + "bias." the cold start loader is not used un- 
til the system is powered up again, as long as the bios 
is not overwritten, the origin is assumed at 0000h, an 
must be changed if the controller brings the cold start 
loader into another area, or if a read/only memory area 
is used. 



0000 






org 





0014 


= 


msize 


equ 


20 


0000 


= 


bias 


egu 


(msize-20) *1024 


3400 


= 


ccp 


equ 


3400h+bias 


4a00 


= 


bios 


equ 


ccp+1600h 


0300 


= 


biosl 


equ 


0300h 


4a00 


= 


boot 


equ 


bios 


1900 


= 


size 


equ 


bios+biosl-ccp 


0032 


= 


sects 


equ 


size/128 



base of ram in cp/m 
min mem size in kbytes 



offset from 
base of the 
base of the bios 
length of the bios 



20k system 
ccp 



size of cp/m system 
# of sectors to load 



begin the load operation 



cold: 



0000 


010200 


lxi 


b,2 


0003 


1632 


mvi 


d , sects 


0005 


210034 


lxi 


h,ccp 



b=0 , c=sector 2 
d=# sectors to load 
base transfer address 



lsect: 



load the next sector 



insert inline code at this point to 
read one 128 byte sector from the 
track given in register b, sector 
given in register c, 
into the address given by <hl> 

branch to location "cold" if a read error occurs 
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************************************************* 
* 

* user supplied read operation goes here... 
* 

************************************************* 



0008 c36b00 
000b 



jmp oast$patch 
ds 60h 



; remove this when patche 



006b 15 
006c ca004a 



past$patch: 

; go to next sector if load is incomplete 

dcr d ; sects=sects-l 

jz boot ; head for the bios 

more sectors to load 

we aren't using a stack, so use <sp> as scratch registe 
to hold the load address increment 



006f 


318000 


lxi 


sp r 128 


0072 


39 


dad 


sp 


0073 


0c 


inr 


c 


0074 


79 


mov 


a,c 


0075 


felb 


cpi 


27 


0077 


da0800 


jc 


lsect 



; 128 bytes per sector 

; <hl> = <hl> + 128 

; sector = sector + 1 

; last sector of track? 

; no, go read another 



; end of track, increment to next track 



007a 


0e01 


mvi 


c,l 


007c 


04 


inr 


b 


007d 


C30800 


jmp 


lsect 


0080 




end 





sector = 1 
track = track + 1 
for another group 
of boot loader 
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APPENDIX F: CP/M DISK DEFINITION LIBRARY 

CP/M 2.0 disk re-definition library 

Copyright (c) 1979 

Digital Ribearch 

Box 5 79 

Pacific Grove, CA 

93950 

CP/M logical disk drives are defined using the 
macros given below, where the sequence of calls 
is: 

disks n 

diskdef parameter-list-0 

diskdef parameter-list-1 

• • • 

diskdef parameter-list-n 
endef 

where n is the number of logical disk drives attached 
to the CP/M system, and parameter-list-i defines the 
characteristics of the ith drive (i=0 ,1 , . . . ,n-l) 

each parameter-list-i takes the form 

dn,fsc,lsc, [skf] ,bls,dks,dir ,cks r of s f [0] 
where 

dn is the disk number 0,1,..., n-1 

fsc is tae first sector number (usually or 1) 

lsc is the last sector number on a track 

skf is optional "skew factor" for sector translate 

bis is tne data block size (1024,2048 ,... ,16384) 

dks is tne disk size in bis increments (word) 

dir is tne: number of directory elements (word) 

cks is the number of dir elements to checksum 

ofs is the number of tracks to skip (word) 

[0] is an optional which forces l6K/directory en 

for convenience, the form 

dn,dm 
defines disk dn as having the same characteristics as 
a previously defined disk dm. 

a standard four drive CP/M system is defined by 

disks 4 

diskdef 0,1,26,6,1024,243,64,64,2 
dsk set 

rept 3 
dsk set dsk+1 

diskdef %dsk,0 

endm 

endef 

the value of "begdat" at the end of assembly defines t 
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54 
55 
56 
57 
58 
59 
60 
61 
62 
63 
64 
65 
66 
67 
68 
69 
70 
71 
72 
73 
74 

7 5 
76 
77 
78 
79 
80 
81 
82 
83 
84 
85 
86 

8 7 
88 
89 
90 
91 
92 
93 
94 
95 
96 
97 
98 
99 

100 
101 
102 
103 
104 
105 
106 
107 
108 



dskhdr 
dpe&dn 



disks 

• • 

ndisks 
dpbase 



dsknxt 



dsknxt 



dpbhdr 
dpb&dn 



ddb 



ddw 



gcd 



gcdm 
gcdn 
gcdr 

gcdx 
gcdr 



beginning of the uninitialize ram area above the bios, 
while the value of "enddat" defines the next location 
following the end of the data area. the size of this 
area is given by the value of "datsiz" at the end of t 
assembly. note that the allocation vector will be qui 
large if a large disk size is defined with a small bio 
size. 

macro dn 

define a single disk header list 



dw 
dw 
dw 
dw 
endm 



xlt&dn,0000h 
0000h r 0000h 
dirbuf , dpb&dn 
csv&dn,alv&dn 



; translate table 
;scratch area 
;dir buff,parm block 
;check, alloc vectors 



macro nd 

define nd disks 

set nd ;;for later reference 

equ $ ;base of disk parameter blocks 

generate the nd elements 

set 

rept nd 

dskhdr %dsknxt 

set dsknxc+1 

endm 

endm 



macro 

equ 

endm 



dn 



;disk parm block 



macro data, comment 

define a db statement 

db data 
endm 

macro data, comment 

define a dw statement 

dw data 
endm 



comment 



comment 



macro m,n 

greatest common divisor of m,n 

produces value gcdn as result 

(used in sector translate table generation) 



set 

set 

set 

rept 

set 

set 

if 

exitm 

endif 



m 

n 



65535 

gcdm/gcdn 

gcdm - gcdx*gcdn 

gcdr = 



;variable for m 
;variable for n 
;variable for r 
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109 

110 

111 

112: 

113 

114 

115 

116 

117 

118 

119 

120 

121 

122: 

123 

124 

125 

126 

127 

128 

129 

130 

131 

132 

133 

134 

135 

136 

137 

138 

139 

140 

141 

142: 

143 

144 

145 

146 

147 

148 

149 

150 

151 

152 

153 

154 

155 

156 

157 

158 

159 

160 

161 

162 

163 



gcdm 
gcdn 



set 
set 
endm 
endm 



gcdn 
gcdr 



diskdef macro dn r f sc, lsc,skf , bis , dks,dir , cks,of s, kl6 
; ? generate the set statements for later tables 



dpb&dn 
ais&dn 
css&dn 
xlt&dn 

secmax 

sectors 

als&dn 

als&dn 

css&dn 

blkval 
blkshf 
blkmsk 



blkshf 
blkmsk 
blkval 



blkval 
extmsk 



extmsk 
olkval 



extmsk 



extmsk 



d i r r em 



if nul lsc 

current disk dn 

equ dpb&fsc 

equ als&fsc 

equ css&fsc 

equ xlt&fsc 

else 

set 

set 

set 

if 

set 

endif 

set (cks)/4 ;;number of checksum elements 

generate the block shift value 

set bls/128 

set 

set 

rept 16 

if' blkval=l 

exitm 

endif 

otherwise, high order 1 not found yet 

set blkshf+1 

set (blkmsk shl 1) or 1 

set blkval/2 

endm 

generate the extent mask byte 



same as previous fsc 
equivalent parameters 
same allocation vector size 
same checksum vector size 
same translate table 



lsc-(fsc) ;;sectors 0... secmax 
secmax+1; ;number of sectors 
(dks)/8 ;;size of allocation vector 
( (dks) mod &) ne 
als&dn+l 



;number of sectors/block 
jcounts right 0's in blkval 
;rills with l's from right 
;once for each bit position 



;;number of kilobytes/block 
1 from right with l's 



set bls/1024 

set ; ; f i. 

rept 16 

if blkval=l 

exitm 

endif 

otherwise more to shift 

set (extmsk shl 1) or 

set blkval/2 

endm 

may be 

if 

set 

endif 

may be optional [0] 

if not nul kl6 

set kl6 

endif 

now generate directory reservation bit vector 

set dir ;;# remaining to process 



double byte allocation 
(dks) > 256 
(extmsk shr 



1) 

in last position 
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164: dirbks set bls/32 ;; number of entries per block 

165: dirblk set ;;f.ill with l*s on each loop 

166: rept 16 

167: if dirrem=0 

168: exitm 

169: endif 

170: ;; not complete, iterate once again 

171: ;; shift right and add i high order bit 

172: dirblk set (dirblk shr i) or 8000h 

173: if dirrem > dirbks 

174: dirrem set dirrem-dirbks 

175: else 

176: dirrem set 

177: endif 

178: endm 

179: dpbhdr dn ; ;generate equ $ 

180: ddw %sectors, < ; sec per track> 

181: ddb %blkshf , < ;blcck " shif t> 

182: ddb %blkmsk ,< ;blcck mask> 

183: ddb %extmsk ,< ;extnt mask> 

184: ddw % (dks) -1 f < ;aisk size-l> 

185: ddw % (dir ) -1 , < ;airectory max> 

186: ddb %dirblk shr 8,<;alloc0> 

187: ddb %dirblk ana 0f f h f < ; allocl> 

188: ddw % (cks) /4 , < ;check size> 

189: ddw %of s, < ;of f set> 

190: ;; generate the translate table, if requested 

191: if nul skf 

192: xlt&dn equ ;no xlate table 

193: else 

194: if skf = 

195: xlt&dn equ ;no xlate table 

196: else 

197: ;; generate the translate taole 

198: nxtsec set ;;aext sector to fill 

199: nxtbas set ;;mcves by one on overflow 

200: gcd %sectors,skf 

201: ;; gcdn = gcd(sectors r skew) 

202: neltst set sectors/gcdn 

203: ; ; neltst is number of elements to generate 

204: ;; before we overlap orevious elements 

205: nelts set neltst ;;counter 

206: xlt&dn equ $ ;translate table 

207: rept sectors ; ;once for each sector 

208: if sectors < 256 

209: ddb %nxtsec+ (f sc) 

210: else 

211: ddw %nxtsec+(fsc) 

212: endif 

213: nxtsec set nxtsec+(skf) 

214: if nxtsec >= sectors 

215: nxtsec set nxtsec-sectors 

216: endif 

217: nelts set nelts-1 

218: if nelts = 
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219: nxtbas set nxtbas+i 

220: nxtsec set nxtbas 

221: nelts set neltst 

222: endif 

223: endm 

224: endif ; ;end of nul fac test 

225: endif ; ;end of nul bis test 

226: endm 

227: ; 

228: defds macro lab, space 

229: lab: ds space 

230: endm 

231: ; 

232: Ids macro lb,dn,val 

233: defds lb&dn, %val&dn 

234: endm 

235: ; 

236: endef macro 

237: ;; generate the necessary ram data areas 

238: begdat equ $ 

239: dirbuf: ds 128 ;directory access buffer 

240: dsknxt set 

241: rept ndisks ; ;once for eacn disk 

242: Ids alv, %dsknxt ,als 

243: Ids csv , %dsknxt ,css 

244: dsknxt set dsknxt+1 

245: endm 

246: enddat equ $ 

247: datsiz equ $-begdat 

248: ;; db at this point forces hex record 

249: endm 
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APPENDIX G: BLOCKING AND DEBLOCKING ALGORITHMS. 



1 
2 
3 
4 
5 
6 
7 
8 
9 
10 
11 
12 
13 
14 
15 
16 
17 
18 
19 
20 
21 
22 
23 
24 
25 
26 
27 
28 
29 
30 
31 
32 
33 
34 
35 
36 
37 
38 
39 
40 
41 
42 
43 
44 
45 
46 
47 
48 
49 
50 
51 
52 
53 



***************************************************** 

* * 

* Sector Deblocking Algorithms for CP/M 2.0 * 
***************************************************** 

utility macro to compute sector mask 
smask macro hblk 

;; compute log2(hblk), return @x as result 
;; (2 ** @x = hblk on return) 
@y set hblk 
@x set 
; ; count right shifts of @y until = 1 

rept 8 

if @y = 1 

ex i tin 

endif 
;; @y is not 1, shift right one position 
@y set @y shr 1 
@x set @x + 1 

endm 

endm 

***************************************************** 

* * 

* CP/M to host disk constants * 

* * 

***************************************************** 



blksiz equ 

hstsiz equ 

hstspt equ 

hstblk equ 

cpmspt equ 

secmsk equ 

smask 

secshf equ 



2048 

512 

20 

hstsiz/128 

hstblk * hstspt 

hstblk-1 

hstblk 

@x 



CP/M allocation size 
host disk sector size 
host disk sectors/trk 
CP/M sects/host buff 
CP/M sectors/track 
sector mask 
compute sector mask 
log2 (hstblk) 



***************************************************** 

* * 

* BDOS constants on entry to write * 

* * 

***************************************************** 
wrall equ ;write to allocated 



wrdir 
wrual 



equ 
equ 
equ 



;write to directory 
;write to unallocated 



***************************************************** 

* * 

* The BDOS entry points given below show the * 

* code which is relevant to deblocking only. * 

* * 

***************************************************** 
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54 
55 
56 
57 
58 
59 
60 
61 
62 
63 
64 
65 
66 
67 
68 
69 
70 
71 
72 
73 
74 
75 
76 
77 
78 
79 
80 
81 
82 
83 
84 
85 
86 
87 
88 
89 
90 
91 
92 
93 
94 
95 
96 
97 
98 
99 
100 
101 
102 
103 



dpbase 

boot: 
wboot: 



seldsk 



settrk: 



setsec 



setdma 



DISKDEF macro, or hand coded tables go here 
egu $ ;disk param block base 



;enter here on system boot to initialize 



xra 
sta 
sta 
ret 



a 

hstact 

unacnt 



to accumulator 
host buffer inactive 
clear unalloc count 



;select disk 



mov 

sta 

mov 

mvi 

rept 

dad 

endm 

lxi 

dad 

ret 



a,c 

sekdsk 

Ira 

h r 

4 

h 

d, dpbase 
d 



;selected disk number 
;seek disk number 
;disk number to HL 

;multiply by 16 



;base of parm block 
;hl=.dpb (curdsk) 



sectran: 



;set track given by registers BC 

mov h r b 

mov l f c 

shld sektrk ; track to seek 

ret 



;set sector given by register c 

mov a,c 

sta seksec ;sector to seek 

ret 



;set dma address given by BC 

mov h r b 

mov l,c 

shld dmaadr 

ret 



; translate sector number BC 
mov h,b 
mov l r c 
ret 
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104 
105 
106 
107 
108 
109 
110 
111 
112 
113 
114 
115 
116 
117 
118 
119 
120 
121 
122 
123 
124 
125 
126 
127 
128 
129 
130 
131 
132 
133 
134 
135 
136 
137 
138 
139 
140 
141 
142 
143 
144 
145 
146 
147 
148 
149 
150 
151 
152 
153 
154 
155 
156 
157 
158 



***************************************************** 

* * 

* The READ entry point takes the place of * 

* the previous BIOS def intion for READ. * 

* * 

***************************************************** 

read: 

;read the selected CP/M sector 

mvi a r l 

sta readop ;read operation 

sta rsflag ;must read data 

mvi a,wrual 

sta wrtype ;treat as unalloc 

jmp rwoper ;to perform the read 

***************************************************** 

* * 

* The WRITE entry point takes the place of * 

* the previous BIOS defintion for WRITE. * 

* * 

***************************************************** 

write: 

;write the selected CP/M sector 

xra a ;0 to accumulator 

sta readop ;not a read operation 

mov a,c ;write type in c 

sta wrtype 

cpi wrual ;write unallocated? 

jnz chkuna ;check for unalloc 

; write to unallocated, set parameters 

mvi a,blksiz/128 ;next unalloc recs 

sta unacnt 

Ida sekdsk ;disk to seek 

sta unadsk ;unadsk = sekdsk 

lhld sektrk 

shld unatrk ;unatrk = sectrk 

Ida seksec 

sta unasec ;unasec = seksec 



chkuna: 



;check for write to unallocated sector 

Ida unacnt ;any unalloc remain? 

ora a 

jz alloc ;skip if not 



more unallocated records remain 

dcr a 

sta unacnt 

Ida sekdsk 

lxi h r unadsk 

cmp m 

jnz alloc 

disks are the same 



; unacnt = unacnt-1 

;same disk? 

;sekdsk = unadsk? 
;skip if not 



68 



159 

160 

161 

162: 

163 

164 

155 

166 

167 

168 

169 

170 

171 

172 

173 

174 

175 

176 

177 

178 

179 

180 

181 

182 

183 

184 

185 

186 

187 

188 

189 

190 

191 

192 

193 

194 

195 

196 

197 

198 

199 

200 

201 

202 

203 

204 

205 

206 

207 

208 

209 

210 

211 

212 

213 



lxi 


h,unatrk 




call 


sektrkcmp 


;sektrk = unatrk? 


jnz 


alloc 


;skip if not 



tracks are the same 
Ida seksec 
lxi h r unasec 
crt) m 
jnz alloc 



; same sector? 

; seksec = unasec? 
jskip if not 



match, move to next sector for future ref 

; unasec = unasec+1 
;end of track? 
;count CP/M sectors 
;skip if no overflow 



inr 


m 


mov 


a r m 


cpi 


cpmspt 


jc 


noovf 


overf 1 


ow to next track 


mvi 


m r 


lhld 


unatrk 


inx 


h 


shld 


unatrk 



noovf: 



; unasec = 
;unatrk = unatrk+1 
;match found, mark as unnecessary read 



xra 

sta 
jmp 



a 

rsflag 

rwoper 



to accumulator 

rsflag = 

to perform the write 



alloc: 



;not an unallocated record, requires pre-read 



xra 
sta 
inr 
sta 



a 

unacnt 
a 
rsflag 



to accum 
unacnt = 

1 to accum 
rsflag = 1 



************************* * * ************************** 

* * 

* Common code for READ and WRITE follows * 

* * 

***************************************************** 

rwoper: 

;enter here to perform the read/write 

;zero to accum 
;no errors (yet) 
;compute host sector 

; carry = 
;shift right 

;host sector to seek 



;host active flag 
; always becomes 1 



xra 


a 


sta 


erf lag 


Ida 


seksec 


rept 


secshf 


ora 


a 


rar 




endm 




sta 


sekhst 


active 


host sector? 


lxi 


h f hstact 


mov 


a f m 


mvi 


m,l 
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214 
215 
216 
217 
218 
219 
220 
221 
222 
223 
224 
225 
226 
227 
228 
229 
230 
231 
232 
233 
234 
235 
236 
237 
238 
239 
240 
241 
242 
243 
244 
245 
246 
247 
248 
249 
250 
2 51 
252 
253 
254 
255 
256 
257 
258 
259 
260 
261 
262 
263 
264 
265 
266 
267 
268 



ora 

jz 



a 

f ilhst 



;was it already? 
;fill host if not 



f ilhst: 



match: 



host buffer active, same as seek buffer? 

Ida sekdsk 

lxi h, hstdsk ;same disk? 

cmp m ; sekdsk = hstdsk? 

jnz nomatch 

same disk r same track? 

lxi h,hsttrk 

call sektrkcmp ;sektrk = hsttrk? 

jnz nomatch 

same disk, same track, same buffer? 

Ida sekhst 

lxi h,hstsec ;sekhst = hstsec? 

cmp m 

jz match ;skip if match 



nomatch: 



;proper disk, but not correct sector 

Ida hstwrt ;host written? 

ora a 

cnz writehst ;clear host buff 



;may have to fill 

Ida sekdsk 

sta hstdsk 

lhld sektrk 

shld hsttrk 

Ida sekhst 

sta hstsec 

Ida rsflag 

ora a 

cnz readhst 

xra a 

sta hstwrt 



the host buffer 



;need to read? 



;yes, 
;0 to 



if 1 
accum 



;no pending write 



;copy 

Ida 

ani 

mov 

mvi 

rept 

dad 

endm 

hi has 

lxi 

dad 

xchg 

lhld 

mvi 



data to or 
seksec 
secmsk 
Ira 
h,0 
7 
h 



from buffer 

;mask buffer number 
;least signif bits 
; ready to shift 
;double count 
;shift left 7 



relative host 
d,hstbuf 
d 

dmaadr 
c,128 



buffer address 

;hl = host address 
;now in DE 
;get/put CP/M data 
; length of move 
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269 

270 
271 
272 
273 
274 
275 
276 
277 
278 
279 
280 
281 
282 
283 
284 
285 
286 
287 
288 
289 
290 
291 
292 
293 
294 
295 
296 
297 
298 
299 
300 
301 
302 
303 
304 
305 
306 
307 
308 
309 
310 
311 
312 
313 
314 
315 
316 
317 
318 
319 
320 



Ida 


readop 


ora 


a 


jnz 


rwmove 



rwmove 



;which way? 
;skip if read 



write operation, mark and switch direction 

mvi a f l 

sta hstwrt ;hstwrt = 1 

xchg ;source/dest swap 



;C initially 128, DE is source, HL is dest 

ldax d ; source character 

inx d 

mov m,a ; to dest 

inx h 

dcr c ;loop 128 times 

jnz rwmove 

m 

data has been moved to/from host buffer 
Ida wrtype ; write type 

cpi wrdir ; to directory? 

Ida erflag ;in case of errors 

rnz ;no further processing 

clear host buffer for directory write 

errors? 
skip if so 
to accum 
buffer written 



ora 


a ; 


rnz 




xra 


a ; 


sta 


hstwrt ; 


call 


wr itehst 


Ida 


erflag 


ret 





***************************************************** 

* . * 

* Utility subroutine for 16-bit compare * 

* " * 

***************************************************** 

sektrkcmp: 

;HL = .unatrk or .hsttrk, compare with sektrk 

xchg 

lxi h, sektrk 

ldax d ;low byte compare 

cmp m ;same? 

rnz ;return if not 
; low bytes equal, test high Is 

inx d 

inx h 

ldax d 

cmp m ;sets flags 

ret 
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321 

322: 

323 

324 

325 

326 

327 

328 

329 

330 

331 

332 

333 

334 

335 

336 

337 

338 

339 

340 

341 

342 

343 

344 

345 

346 

347 

348 

349 

350 

351 

352 

353 

354 

355 

356 

357 

358 

359 

360 

361 

362 

363 

364 

365 

366 

367 

368 

369 

370 



*********** * * **************************************** 

* * 

* WRITEHST performs the physical write to * 



the host disk, READHST reads the physical 
disk. 



***************************************************** 

writehst: 

;hstdsk = host disk # r hsttrk = host track #, 
;hstsec = host sect #. write "hstsiz" bytes 
;from hstbuf and return error flag in erflag. 
;return erflag non-zero if error 
ret 

readhst: 

;hstdsk = host disk # r hsttrk = host track #, 
;hstsec = host sect #. read "hstsiz" bytes 
;into hstbuf and return error flag in erflag. 
ret 

***************************************************** 

* * 

* Unitialized RAM data areas * 

* * 

*************************************„*************** 



sekdsk: 
sektrk : 
seksec: 

hstdsk: 
hsttrk : 
hstsec: 

sekhst: 
hstact: 
hstwr t 

unacnt: 
unadsk: 
unatrk ; 
unasec 

erflag 
rsflag 
read op 
wrtype 
dmaadr 
hstbuf 



ds 
ds 
ds 

ds 
ds 
ds 

ds 
ds 
ds 

ds 
ds 
ds 
ds 

ds 
ds 
ds 
ds 
ds 
ds 



1 
2 
1 

1 
2 
1 

1 
1 

1 

1 
1 
2 
1 

1 
1 
1 
1 
2 
hstsiz 



;seek disk number 
;seek track number 
;seek sector number 

;host disk number 
;host track number 
;host sector number 

;seek shr secshf 
;host active flag 
;host written flag 

;unalloc rec cnt 
;last unalloc disk 
;last unalloc track 
;last unalloc sector 

;error reporting 
;read sector flag 
;1 if read operation 
;write operation type 
;last dma address 
;host buffer 
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371 
372 
373 
374 
375 
376 



***************************************************** 

* * 

* The ENDEF macro invocation goes here * 

* * 

***************************************************** 
end 



73 



11.0 SERVICE INFORMATION 

11.1 SERVICE PROCEDURES 

1 1 .2 LOST OR DAMAGED 
EQUIPMENT 

11.3 ADDITIONAL TECHNICAL 
DOCUMENTATION 

11.4 NON-DISCLOSURE 
AGREEMENT 

11.5 EQUIPMENT 
MALFUNCTION REPORT 

11.6 LIMITED WARRANTY I 
REGISTRATION FORM 

11.7 CUSTOMER COMMENT 
CARD 



11.1 SERVICING PROCEDURES 

Your CompuStar Video Processing System is warranted to the 
original purchaser for 90 days from date of shipment. This 
warranty covers the adjustment or replacement F.O.B. Intertec's 
plant in Columbia, South Carolina of any part or parts which in 
Intertec's judgment shall disclose to have been originally 
defective. A complete statement of your warranty rights is 
contained on the inside back cover of this manual. 

In order to register your warranty, the Warranty Registration 
form (contained in this section) must be completed in full and 
returned to Intertec Data Systems within 10 days of receipt of 
this equipment. Be sure to include the serial number of the 
specific terminal you are registering. The serial number of your 
terminal can be found on the rear I/O panel next to the power 
cord. A Customer Comment Card is also enclosed for your 
convenience if you desire to make comments regarding the overall 
operation and/or adaptability of the CompuStar to your particular 
application. Completion of the Customer Comment Card is 
optional . 

IF SERVICE IS EVER REQUIRED: 

If you should encounter difficulties with the use or operation of 
this equipment, contact the supplier from whom the unit was 
purchased for instructions regarding the proper servicing tech- 
niques. Service procedures differ from dealer to dealer but most 
Intertec authorized service dealers can provide local, on-site 
servicing of this equipment on a per-call or maintenance contract 
basis. Plus, a variety of service programs are available 
directly from the factory including extended warranty, a module 
exchange program and on-site contract maintenance from over 50 
locations in the U.S. 

If you are not covered under one of the three programs described 
above and service cannot be made available through your local 
supplier , contact Intertec f s Customer Service Department at ( 803) 
798-9100. Be prepared to give the following information when you 
call : 

1. The serial number of the equipment which is defective. 
If you are returning individual modules to the factory 
for repair, it will be necessary to have the serial 
number of the individual modules also. The serial number 
of the entire terminal may be found on the rear 1/0 panel 
just to the right of the power cord. Module serial 
numbers are listed on white stickers placed in 
conspicuous locations on each major module or subassembly 
of the terminal. 

NOTE: Individual modules cannot be returned to the 
factory for repair unless you originally purchased your 
unit directly from the factory. I_f your unit was 
purchased through a Dealer or OEM vendor , and you desire 



factory repair , then the entire terminal must be 
returned . 

2. The name and location of the Dealer and/or Agent from 
which the unit was purchased. 

3. A complete description of the alleged failure (including 
the nature and cause of the failure if readily 
available. 

The Customer Service Department will issue you Return Material 
Authorization Number (RMA Number) which will be valid for a 
period of 30 days. This RMA Number will be your official 
authorization to return equipment to IDSC for repair only. The 
Customer Service Department will also give you an estimate, if 
requested, of the time it should take to process and repair your 
equipment. Turnaround time on repairs varies depending on 
workloads and availability of parts but normally your equipment 
will be repaired and returned to you within 10 working days of 
its receipt. If your repair is urgent, you may authorize a 
special $50 Emergency Repair fee and have your equipment repaired 
and returned within no more than 48 hours of its receipt at our 
Service Center. Ask the Customer Service Department for more 
information about this program. 

IMPORTANT: Any equipment returned to Intertec without an RMA 
Number will result in the equipment being refused and possible 
cancellation of your SuperBrain warranty. Also if your RMA 
Number expires , you msut request a new number . Equipment 
arriving at Intertec bearing expired RMA Number will also be 
refused . 

After securing an RMA Number from the Customer Service 
Department, return the specified modules and/or complete teminals 
to Intertec, freight prepaid, at the address below. NOTE: The 
RMA Number must be plainly marked and visible on your shipping 
label to prevent the equipment from being refused at Intertec ' s 
Receiving Department . 

ATTN: FACTORY SERVICE CENTER 
Intertec Data Systems Corporation 
2300 Broad River Road 
Columbia, South Carolina 29210 

To aid our technicians in troubleshooting and correcting your 
reported malfunction, please complete an Intertec Equipment Mal- 
function Report (contained in this section) and enclose it with 
the equipment you intend to return to the factory. 

Be sure a declared value equal to the price of the unit is shown 
on the bill of Lading, Express Receipt of Air Freight Bill, 
whichever is applicable. Risk of loss or damage to equipment 
during the time it is in transit either to or from Intertec's 
facilities is your sole responsibility. A* declared value must be 
placed on your Bill of Lading to insure substantiation of your 



freight claim if shipping damage or loss is incurred. 



All equipment returned to an Intertec Service Center must be 
freight prepaid . Equipment not prepaid on arrival at Intertec's 
Receiving Department cannot be accepted. Upon repair of the 
defective equipment, it will be returned to you, F.O.B. the 
factory in Columbia, via UPS or equivalent ground transportation 
unless you specify otherwise. 



11.2 INSTRUCTIONS FOR HANDLING LOST OR DAMAGED EQUIPMENT 

The goods described on your Packing Slip were delivered to the 
Transportation Company at Intertec's premises in complete and 
good condition. If any of the goods called for on this Packing 
Slip are short or damaged, you must file a claim WITH THE TRANS- 
PORTATION COMPANY FOR THE AMOUNT OF THE DAMAGE AND/OR LOSS. 

IF LOSS OR DAMAGE H> EVIDENT AT TIME OF DELIVERY 

If any of the goods called for on your Packing Slip are short or 
damaged at the time of delivery, ACCEPT THEM, but insist that the 
Freight Agent make a damaged or short notation on your Freight 
Bill or Express Receipt and sign it. 

IT DAMAGE OR LOSS IS CONCEALED AND DISCOVERED AT A LATER DATE 

If any concealed loss or damage is discovered, notify your local 
Freight Agent or Express Agent AT ONCE and request him to make an 
inspection. This is absolutely necessary. Unless you do this, 
the Transportation Company will not consider your claim for loss 
or damage valid. If the agent refuses to make an inspection, you 
should draw up an affidavit to the effect that you notified him 
on a certain date and that he failed to make the necessary 
inspection. 

After you have ascertained the extent of the loss or damage, 
ORDER THE REPLACEMENT PARTS OR COMPLETE NEW UNITS FROM THE 
FACTORY. We will ship to you and bill you for the cost. This 
new invoice will then be a part of your claim for reimbursement 
from the Transportation Company. This together with other 
papers, will properly support your claim. 

IMPORTANT : The claims adjustment procedure for UPS shipments 
varies somewhat from the procedure listed above for regular motor 
and air freight shipments. I_f your equipment was shipped via UPS 
and sustained either damage or loss , the UPS representative in 
your area must initiate the claim by inspecting the goods and 
assigning a_ freight claim number to the damaged equipment . The 
representative will attach a "Call Tag" to the outside of the 
equipment box which will be your authorization to return the 
merchandise to our factory for claim adjustment. Upon receipt of 
this damaged eqiupment, we will perform the necessary repairs, 
process the appropriate paperwork with UPS and return the equip- 
ment to you. Please allow time for processing any type claim. 
Normal time for proper processing of a UPS claim is 15-30 working 
days . 

Remember, it is extremely important that you do not give the 
Transportation Company a clear receipt if damage or shortages are 
evident upon delivery. It is equally important that you call for 
an inspection if the loss or damage is discovered later. D'O NOT, 
UNDER ANY CIRCUMSTANCES, ORDER THE TRANSPORTATION COMPANY TO 
RETURN SHIPMENT TO OUR FACTORY OR REFUSE SHIPMENT UNLESS WE HAVE 
AUTHORIZED SUCH RETURN. 



11.3 ADDITIONAL TECHNICAL INFORMATION 

Additional Technical documentation (i.e., schematics) describing 
the operation of the CompuStar System and the electrical inter- 
connection of its various modules is available at a nominal cost 
directly from Intertec Data System Corporation. However, due to 
the confidentiality of this technical information, it will be 
necessary to sign and return the Documentation Non-Disclosure 
Agreement (appearing on the next page) denoting your concurrence 
with its terms and conditions. 

The handling and processing costs of CompuStar technical documen- 
tation is $50. Due to the large amount of requests being pro- 
cessed and the relatively small handling costs involved, we must 
request that you enclose payment ($50) upon return of your Non- 
Disclosure Agreement . Normally the documents will be mailed to 
you within 15 to 30 days after receipt of your payment and a 
signed copy of the Agreement. (IMPORTANT: The technical 
documentation will be mailed to the address listed at the top of 
the Non-Disclosure Agreement.) For prompt processing of your 
documentation request, please forward your signed agreement and 
payment to: 

Customer Service Department 
Intertec Data Systems Corporation 
2300 Broad River Road 
Columbia, South Carolina 29210 

NOTE: Technical documentation for the CompuStar will be sent to 
you normally within 10-15 days of receipt of your payment and 
signed Non-Disclosure Agreement. 

IMPORTANT: Payment must accompany your Non-Disclosure 
Agreement . Agreements sent to us without payment will be dis- 
carded without notice. 
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COMPUSTAR NON-DISCLOSURE AGREEMENT 

IDS-350B 



YOUR COMPANY 
ADDRESS 



THIS AGREEMENT MADE BETWEEN INTERTEC 
DATA SYSTEMS CORPORATION AND THE 
ORGANIZATION AND/OR PERSONS LISTED AT THE 
RIGHT AND BECOMES EFFECTIVE ON THE DATE 
SPECIFIED BELOW. 

(PLEASE PRINT CLEARLY. DOCUMENTS WILL BE 
MAILED TO THE ADDRESS AT RIGHT) 

For and in consideration of receiving confidential documentation on the CompuStar™ line of terminals manufactured 
by INTERTEC DATA SYSTEMS CORPORATION (hereinafter called INTERTEC) at the date hereof, the undersigned 
hereby agrees with INTERTEC as follows: 



CITY & STATE. 
TELEPHONE . 
YOUR NAME . 



(1) The undersigned acknowledges that formulae, pro- 
grams, manufacturing processes, devices, techniques, 
plans, methods, drawings, blueprints, reproductions, data, 
tables, calculations and components were designed and 
developed by INTERTEC at great expense and over 
lengthy periods of time, and the same are secret and con- 
fidential, are unique and constitute the exclusive property 
and trade secrets of INTERTEC, and that any use of such 
property and trade secrets by the undersigned other than 
for the sole benefit of INTERTEC would be wrongful, tor- 
tious and would cause irreparable injury to INTERTEC. 

(2) The undersigned shall not at any time, without the 
express written consent of the Board of Directors of 
INTERTEC, publish, disclose, use or divulge to any person, 
firm or corporation, directly or indirectly, or use for his own 
benefit or the benefit of any person, firm, or use other than 
to effect repair of INTERTEC manufactured equipment, 
and property above described, trade secrets or confiden- 
tial information of INTERTEC, its subsidiaries and its af- 
filiates learned or obtained by its subsidiaries and its af- 
filiates learned or obtained by him from INTERTEC, in- 
cluding, but not limited to, the information and things set 
forth in paragraph 1 hereinabove. 

(3) This agreement shall be binding upon the under- 
signed, his personal representatives, successors and 
assigns, and shall run to the benefit of INTERTEC, its suc- 
cessors and assigns. 

(4) Upon termination of the association of the under- 



signed with INTERTEC. or its subsidiaries, the undersigned 
shall promptly deliver to INTERTEC all drawings, 
blueprints, reproductions, manuals, letters, notes, 
notebooks, reports, data, tables, calculations or copies 
thereof, components, programs, and any and all other 
secret and confidential property of INTERTEC, its sub- 
sidiaries and affiliates, including, but not limited to, all of 
the property set forth in paragraph 1 hereinabove which 
are in the possession or under the control of the 
undersigned. 

(5) The undersigned hereby acknowledges and agrees 
that in the event of any violation hereof, INTERTEC shall be 
authorized and entitled to obtain from any court of compe- 
tent jurisdiction preliminary and permanent injunctive 
relief as well as equitable accounting of all profits or 
benefits arising out of such violation which rights or 
remedies shall be cumulative and in addition to any rights 
or remedies to which INTERTEC may be entitled and that 
the undersigned shall further be directly liable for any and 
all reasonable attorney's fees incurred by INTERTEC to en- 
force this Agreement against the undersigned in a court of 
law. 

(6) The foregoing understanding shall apply to any 
subsequent meetings and/or communications between 
INTERTEC and the above mentioned organization relating 
to the same subject manner, unless modified in writing as 
to any such subsequent meetings and/or communications. 



We would appreciate your signing and returning to us, prior to the release of INTERTEC product documentation, the 
original copy of this agreement denoting your concurrence with the foregoing provisions. 



AGREED TO: 



(YOUR NAME OR COMPANY - PLEASE PRINT) 



INTERTEC DATA SYSTEMS CORPORATION 

SIGNATURE: 



YOUR SIGNATURE: 

In addition to the terms listed above, I further certify that I am duly 
authorized to sign this document on behalf of the organization and/or 
persons requesting that this imformation be supplied by INTERTEC. 

YOUR NAME: 



YOUR TITLE: 



TODAY'S DATE:. 



FOR OFFICE USE ONLY 


DATE RCVD 
OTHER RELE/ 




PROCESSED BY 




\SES 


DATE 


INVOICE NO. 








,„ 1Tr ™-^ 11.5- EQUIPMENT MALFUNCTION REPORT 

INTE<TEC IDS 505A 

DATA 
SY5TEMS® 

Corporate Headquarters 



This equipment purchased from: 

Dealer Name: Address: 



City & State: Telephone: Area L 



Dear Customer: 

We are trying to manufacture the most reliable product possible. You would do us a great 
courtesy by completing this form should you experience any failures. Enclose this form with the 
equipment you intend to return to the dealer or factory for service. (Additional copies of this form 
available upon request.) 

1 . Type Unit Serial No 

Module (if applicable) 



2. Component failed (if available, include Name and Number) 



3. Description of failure (include cause of failure if readily available) 



4. Approximate hours/days of operation to failure 

5. Failure occurred during: 

□ Initial Inspection □ Customer Installation □ Field Use 

6. Personal Comment: 



Your Name Address 



City & State Zip Phone J_ 

Date Signed 



Return this form and equipment to your local dealer or to the factory at the address below. 

ATTN: FACTORY SERVICE CENTER 
Intertec Data Systems Corporation 

2300 Broad River Road 
Columbia, South Carolina 29210 



=11= INTE3TEC 




BE SURE TO INCLUDE YOUR SERIAL NUMBER HERE. 

SERIAL NO 



Corporate Headquarters: 2300 Broad River Road, Columbia, South Carolina 29210 • 803/798-9100 • TWX: 810-666-2115 



COMPUSTAR LIMITED WARRANTY REGISTRATION FORM 

IMPORTANT: This form should be completed within ten days of receipt of your CompuStar Video 
Processing Terminal and returned to Intertec at the following address: 

Intertec Data Systems Corporation 
2300 Broad River Road 
Columbia, South Carolina 29210 

Attn: Warranty Registration Department 

Complete this form in its entirety within ten days of receipt of your equipment in order to 
properly validate your Limited Warranty. All warranty liability is limited to that expressed in the 
most recent edition of the CompuStar Video Terminal User's Manual as published by Intertec 
Data Systems Corporation. 



******** 



Date Received: 

Company: 

Name: 

Title: 



Purchased from:. 



Address: 
City: 



Address: 
City: 



Telephone: _J L 

Sales Agent: 



Country: 



Telephone: A L 



Order Placed On: 
Price Paid: 



******** 



Where did you first hear about the CompuStar? From a: □ Magazine □ Dealer □ Friend 



Why did you decide to purchase the CompuStar? □ Features □ Price □ Appearance 



Was the Dealer and/or Sales Agent knowledgeable about the CompuStar? DYES DNO 
Please explain. 



Questions on the reverse side must be completed to validate your warranty. 



Were you introduced to any other Intertec products? □ YES □ NO (If yes, please 
indicate other products which were mentioned.) 



Are you aware of other Intertec products? □ YES □ NO (If yes, which ones?) 



What other microcomputers related products will you be purchasing in the next 12 months? 
□ Video Terminals □ Printers (matrix) □ Printers (character) □ Disk Systems □ Other 



What is your application for the CompuStar? □ Business □ Scientific □ Educational □ Other 



What are your comments in general concerning the overall operation of the CompuStar? 
□ Outstanding □ Excellent □ Good □ Average □ Unsatisfactory 



Would you like to be placed on our mailing list? □ YES □ NO 

May we use your name as a favorable reference for other customers in your area desiring to pur- 
chase a CompuStar? □ YES □ NO 

Thank you for purchasing the CompuStar Video Processing Terminal. If we may be of further 
assistance to you, please contact our Customer Service Department at the address on the 
reverse side of this form. 




INTE3TEC CUSTOMER COMMENT CARD 

DATA 

SYSTEMS. 

Corporate Headquarters: 2300 Broad River Road, Columbia, South Carolina 2921 



Our past and present customers are directly responsible for the evolution of the 
CompuStar as you see it presented in this manual. Before Intertec began research and 
development of the CompuStar, an extensive user survey was conducted to ascertain 
optimum video computer price/performance ratios to enable us to capture a major por- 
tion of the video computer market. In order that we continue with our commitment to ex- 
cellence in engineering, production and marketing, we would appreciate your comments 
below regarding your overall opinion of the CompuStar. All comments are given careful 
consideration in future product design and become the property of Intertec Data 
Systems Corporation. 



(1) What are your comments concerning the overall appearance of the CompuStar? 
(You may want to comment on color, size and construction.) 



(2) What are your comments (in general) concerning the overall operation of the unit? 



(3) What features about the unit do you like best? 



(4) What features about the unit do you like least? 



Please see additional questions on the reverse side 




(5) Briefly describe your application for the CompuStar. 



(6) What other microcomputer systems do you feel are comparable to the CompuStar 
in both price and performance? 



(7) What changes and/or modifications to the CompuStar could be made to render it 
more suited to your application? 



(8) Your candid comments regarding the operation of and application for the 
CompuStar are greatly appreciated. Address your comments and/or suggestions to: 

MARKETING SERVICES MANAGER 
Intertec Data Systems 
2300 Broad River Road 
Columbia, South Carolina 29210 

(9) If you desire to be contacted by our service, marketing or technical staff regarding 
these comments, please give us your complete name, address and phone number 
below. (This information is optional.) 

Company Name: 

Address: 

City, State & Zip: 

Contact: 



Phone: AREA ( ) EXT 



would like to be contacted by your: □ Sales Department □ Service Department 



12.0 HARDWARE ADDENDA 

12.1 SERIAL COMMUNICATION 
HARDWARE SETUP 

12.2 8251 A USART OPERATION 



I 



12.1 COMPUSTAR SERIAL COMMUNICATIONS DIPSWITCH SETTING PROTOCOL 



On all CompuStar Video Processing Units there exists a small 5 
position dipswitch located in the upper right hand corner of the 
keyboard/CPU module. For the normal mode (*asynchronous communi- 
cation mode) these switches should be set as follows: 

1 - OFF, 2 - OFF, 3 - ON, 4 - ON , 5 - OFF 

For the synchronous communication mode with another unit 
providing the transmitter and receiver clock, the switches should 
be set as follows: 

1 - ON, 2 - ON, 3 - OFF, 4 - OFF, 5 - OFF 

For the synchronous mode with the user terminal providing both 
the transmitter and receiver clock, the switches should be set as 
follows : 

1-OFF, 2-OFF, 3-ON, 4-ON, 5-ON 

Listed below is a brief description of the function of each of 
these switches: 

1 - External Clock to transmitter section of MAIN USART - 

Originates from PIN #15 on MAIN RS232 connector at rear 
of terminal. 

2 - External Clock to receiver section of MAIN USART - 

Originates from Pin #17 on MAIN RS232 connector at rear 
of terminal. 

3 - Internal TX Clock to MAIN USART - When on this switch 

enables the built-in baud rate generator (Western 
Digital BR-1941). NOTE: When this switch is in the 
'ON 1 position, switch 1 MUST be in the 'OFF 1 position. 

4 - Internal RX Clock to MAIN USART - When this switch is 

in the 'ON' position, switch 2 MUST be in the 'OFF' 
position. 

5 - Internal Baud Clock to MAIN Port - This switch enables 

the transmission of the internal baud rate clock 
(Western Digital BR-1941) to the main RS232 port - this 
signal will also appear on Pin #24 of the main port when 
this switch is in the 'ON' position. If this switch is 
not used, it should be left in the 'OFF' position to 
avoid any possible conflict with external RS232 signals. 

* NOTE: The switches were set for the asynchronous communication 
mode before shipping from the factory. 



12.2 8251A USART OPERATION 
DESCRIPTION OF OPERATION— ASYNCHRONOUS 



Transmission— 

When a data character is written into the USART, it auto- 
matically adds a START bit (low level or "space") and the 
number of STOP bits (high level or "mark") specified by 
the Mode Instruction. If Parity has been enabled, an odd 
or even Parity bit is inserted just before the STOP bit(s), 
as spec ified by the Mode Instruction. Then, depending 
on CTS and TxEN, the character may be transmitted as a 
serial data stream a t the T xD output. Data is shifted out by 
the falling edg e of TxC at a transmission rate of TxC, 
TxC/16 or TxC/64, as defined by the Mode Instruction. 

If no data characters have been loaded into the USART, or 
if all available characters have been transmitted, the TxD 
output remains "high" (marking) in preparation for send- 
ing the START bit of the next character provided by the 
processor. TxD may be forced to send a BREAK (con- 
tinuously low) by setting the correct bit in the Command 
Instruction. 



Receive— 

The RxD input line is normally held "high" (marking) by 
the transmitting device. A falling edge (high to low transi- 
tion) at RxD signals the possible beginning of a START bit 
and a new character. The receiver is thus prevented from 
starting in a "BREAK" state. The START bit is verified by 
testing for a "low" at its nominal center as specified by the 
BAUD RATE. If a "low" is detected, it is considered valid, 
and the bit assembling counter starts counting. The bit 
counter locates the approximate center of the data, parity 
(if specified), and STOP bits. The parity error flag (PE) is 
set, if a parity error occurs. Inpu t bits are sampled at the 
RxD pin with the rising edge of RxC. If a high is not de- 
tected for the STOP bit, which normally signals the end 
of an input character, a framing error (FE) will be set. After 
the STOP bit time, the input character is loaded into the 
paraded Data Bus Buffer of the USART and the RxRDY 
signal is raised to indicate to the processor that a character 
is ready to be fetched. If the processor has failed to fetch 
the previous character, the new character replaces the old 
and overrun flag (OE) is set. All the error flags can be reset 
by setting a bit in the Command Instruction. Error flag 
conditions will not stop subsequent USART operation. 



DESCRIPTION OF OPERATION— SYNCHRONOUS 



Transmission— 

As in Asynchronous transmission, the TxD output re- 
mains "high" (marking) until the USART receives the first 
character (usually a SYNC character) from the processor. 
After a Command Instruction has set TxEN and after 
Clear to Send (CTS) goes low, the first character is se rial ly 
transmitted. Data i s shif ted out on the falling edge of TxC 
at the same rate as TxC. 

Once transmission has started, Synchronous Data Pro- 
tocols require that the serial data stream at TxD continue 
at the TxC rate or SYNC will be lost. If a data character is 
not provided by the processor before the USARTTransmit 
Buffer becomes empty, the SYNC character(s) loaded 
directly following the Mode Instruction will be automat- 
ically inserted in the TxD data stream. The SYNC char- 
acters) are inserted to fill the line and maintain synchron- 
ization until the new data characters are available for 
transmission. If the USART becomes empty, and must 
send the SYNC character(s), the TxEMPTY output is 
raised to signal the processor that the Transmitter Buffer 
is empty and SYNC characters are being transmitted. 
TxEMPTY is automatically reset by the next character 
from the processor. 

Receive— 

In Synchronous receive, character synchronization can 
be either external or internal. If the internal SYNC mode 



has been selected, the ENTER HUNT (EH) bit has been 
set by a Command Instruction, the receiver goes into the 
HUNT mode. 

Incoming data on the RxD input is sampled on the rising 
edge of RxC, and the contents of the Receive Buffer are 
compared with the first SYNC character after each bit has 
been loaded until a match is found. If twoSYNC characters 
have been programmed, the next received character is 
also compared. When the (two contiguous) SYNC char- 
acters) programmed have been detected, the USART 
leaves the HUNT mode and is in character synchroniza- 
tion. At this time, the.SYNDET (output) issethigh.SYNDET 
is automatically reset by a STATUS READ. 

If external SYNC has been specified in the Mode Instruc- 
tion, a"one" applied to the SYNDET (input) for at least 
one RxC cycle will synchronize the USART. 

Parity and Overrun Errors are treated the same in the 
Synchronous as in the Asynchronous Mode. If not in 
HUNT, parity will continue to be checked even if the re- 
ceiver is not enabled. Framing errors do not apply in the 
Synchronous format. 

The processor may command the receiver to enter the 
HUNT mode with a Command Instruction which sets 
Enter HUNT (EH) if synchronization is lost. Under this 
condition the Rx register will be cleared to all "ones". 



OPERATION AND PROGRAMMING 



The microprocessor program controlling the COM 8251 A 
performs these tasks: 

• Outputs control codes 

• Inputs status 

• Outputs data to be transmitted 

• Inputs data which has been received 



Control codes determine the mode in which the COM 
8251A will operate and are used to set or reset control 
signals output by the COM 8251 A. 

The Status register contents will be read by the program 
monitoring this device's operation in order to determine 
error conditions, when and how to read data, write data or 
output control codes. Program logic may be based on 
reading status bit levels, or control signals may be used 
to request interrupts. 



INITIALIZING THE COM 8251A 



Figure 1. Control Word Sequences for Initialization 
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ASYNCHRONOUS OPERATION 



SYNCHRONOUS OPERATION 



The COM 8251A may be initialized following a system 
RESET or prior to starting a new serai I/O sequence. The 
USART must be RESET (external or internal) following 
power up and subsequently may be reset at any time 
following completion of one activity and preceding a 
new set of operations. Following a reset; the COM 8251 A 
enters an idle state in which it can neither transmit nor 
receive data. 

The COM 8251 A is initialized with two, three or four con- 
trol words from the processor. Figure 1 shows the sequence 
of control words needed to initialize the COM 8251 A, for 
synchronous or for asynchronous operation. Note that 
in asynchronous operation a mode control is output to 
the device followed by a command. For synchronous 
operation, the mode control is followed by one or two 
SYNC characters, and then a command. 

Only a single address is set aside for mode control bytes, 
command bytes and SYNC character bytes. For this to be 
possible, logic internal to the chipdirects control informa- 
tion to its proper destination based on the sequence in 
which it is received. Following a RESET (external or inter- 
nal), the first control code output is interpreted as a mode 
control. If the mode control specifies synchronous opera- 
tion, then the next one or two bytes (as determined by the 



mode byte) output as control codes will be interpreted as 
SYNC characters. For either asynchronous or synchro- 
nous operation, the next byte output as a control code is 
interpreted as a command. All subsequent bytes output 
as control codes are interpreted as commands. There are 
two ways in which control logic may return to anticipating 
a mode control input; following a RESET input or following 
an internal reset command. A reset operation (internal via 
IR or external via RESET) will cause the USART to inter- 
pret the next "control write", which should immediately 
f ol low the reset, as a Mode I nstruction. 

After receiving the control words the USART is ready to 
communicate. TxRDY is raised to signal the processor 
that the USART is ready to receive a character for trans- 
mission. Concurrently, the USART is ready to receive 
serial data. 
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MODE CONTROL CODES 



The COM 8251A interprets mode control codes as illus- 
trated in Figures 2 and 3. 

Control code bitsOandl determine whethersynchronous 
or asynchronous operation is specified. A non-zero value 
in bits and 1 specifies asynchronous operation and de- 
fines the relationship between data transfer baud rate and 
receiver or transmitter clock rate. Asynchronous serial 
data may be received or transmitted on every clock pulse, 
on every 16th clock pulse, or on every 64th clock pulse, 
as programmed. A zero in both bits and 1 defines the 
mode of operation as synchronous. 

For synchronous and asynchronous modes, control bits 
2 and 3 determine the number of data bits which will be 
present in each data character. In thecaseof a programmed 
character length of less than 8 bits, the least significant 
DATA BUS unused bits are "don't care" when writing data 
to the USART and will be "zeros" when reading data. Rx 
data will be right justified onto DO and the LSB for Tx data 
is DO. 

For synchronous and asynchronous modes, bits 4 and 5 



determine whether there will be a parity bit in each char- 
acter, and if so, whether odd or even parity will beadopted. 
Thus in synchronous mode a character will consist of five, 
six, seven or eight data bits, plus an optional parity bit. In 
asynchronous mode, the data unit will consist of five, six, 
seven or eight data bits, an optional parity bit, a proceeding 
start bit, plus 1, 1 % or 2 trailing stop bits. Interpretation of 
subsequent bits differs for synchronous or asynchronous 
modes. 

Control code bits 6 and 7 in asynchronous modedetermine 
how many stop bits will trail each data unit. Vk stop bits 
can only be specified with a 16X or 64X baud rate factor. 
In these two cases, the half stop bit will be equivanlent to 
8 or 32 clock pulses, respectively. 

In synchronous mode, control bits 6 and 7 determine 
how character synchronization will be achieved. When 
SYNDET is an output, internal synchronization is specified; 
one or two SYNC characters, as specified by control bit 7, 
must be detected at the head of a data stream in order to 
establish synchronization. 



COMMAND WORDS 



Command words are used to initiate specific functions 
within the COM 8251A such as, "reset all error flags" or 
"start searching for sync". Consequently, Command 
Words may be issued by the processor to the COM 8251 A 
at any time during the execution of a program in which 



specific functions are to be initialized within the com- 
munication circuit. 

Figure 4 shows the format for the Command Word. 



Figure 4. COM 8251 A Control Command 
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Bit No. 



TxEN 

1 = Enable transmission 

= Disable transmission 

DTR 

1 = DTR output is forced to 



RxE 

1 = Enable RxRDY 

= Disable RxRDY 

SBRK 

1 = TxD is forced low 

= Normal operation 

ER 

1 = Resets all error flags in 

Status register (PE. OE. FE) 

RT5 

1 = RTS output is forced to 

IR 

1 = Reset format 

EH 

1= Enter HUNT mode 



Figure 2. Synchronous Mode Control Code. 
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Bit No. 



Sync mode 

00 5 bits per character 

01 6 bits per character 

10 7 bits per character 

11 8 bits per character 

= Parity disable, 1 = Parity enable 

= Odd parity, 1 = Even parity 

= SYNDET output 
1=SYNDET input 

= 2 SYNC characters 

1 = 1 SYNC character 



Figure 3. Asynchronous Mode Control Code. 
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■ Bit No. 



A 



" t 



00 Invalid (SYNC mode) 

01 Async mode, 1 X Baud rate factor 

" 1 Async mode, 1 6X Baud rate factor 

1 1 Async mode, 64X Baud rate factor 

00 5 bits per character 

_ 01 6 bits per character 

10 7 bits per character 

11 8 bits per character 

■ = Parity disable, 1 = Parity enable 

■ = Odd parity, 1 = Even parity 

00 Invalid 

.01 1 stop bit 

10 1% stop bits 

1 1 2 stop bits 



6 



Bit of the Command Word is the Transmit Enable bit 
(TxEN). Data transmission for the CO M 825 1 A cannot 
take place unless TxEN is set (assuming CTS = 0) in the 
command register. TheTX Disable command is prevented 
from halting transmission by the Tx Enable logic until all 
data previously written has been transmitted. Figure 5 
defines the way in which TxEN, TxE and TxRDY combines 
to control transmitter operations. 

Bit 1 is the Data Termina l Rea dy (DTR) bit. When the DTR 
com mand bit is set, the DTR output connection is active 
(low). DTR is used to advise a modem thatthedataterminal 
is prepared to accept or transmit data. 



Bit 2 is the Receiver Enable Command bit (RxE). RxE is 
used to enable the RxRDY output signal. RxE, when zero, 
prevents the RxRDY signal from being generated to notify 
the processor that a complete character is framed in the 
Receive Character Buffer. It does not inhibit the assembly 
of data characters at the input, however. Consequently, 
if communication circuits are active, characters will be 
assembled by the receiver and transferred to the Receiver 
Buffer. If RxE is disabled, the overrun error (OE) will prob- 
ably be set; to insure proper operation, the overrun error 
is usually reset with the same command that enables RxE. 





Figure 5. 
Operation of the Transmitter Section as a Function of TxE, TxRDY and TxEN 
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1 1 Transmit Output Register and Transmit Character Buffer empty. 
TxD continues to mark if COM 8251A is in the asynchronous mode. 
TxD will send SYNC pattern if COM 8251A is in the Synchronous 
Mode. Data can be entered into Buffer. 


1 


1 Transmit Output Register is shifting a character. Transmit Character 
Buffer is available to receive a new byte from the processor. 


1 


1 Transmit Register has finished sending. A new character is waiting 
for transmission. This is a transient condition. 


1 


Transmit Register is currently sending and an additional character 
is stored in the Transmit Character Buffer for transmission. 





0/1 0/1 Transmitter is disabled. 



Bit 3 is the Send Break Command bit (SBRK) . When SBRK 
is set, the transmitter output (TxD) is interrupted and a 
continuous binary "0" level, (spacing) is appliedtotheTxD 
output signal. The break will continue until a subsequent 
Command Word is sent to the COM8251AtoremoveSBRK. 

Bit 4 is the Error Reset bit (ER). When a Command Word 
is transferred with the ER bit set, all three error flags (PE, 
OE, FE) in the Status Register are reset. Error Reset occurs 
when the Command Word is loaded into the COM 8251 A. 
No latch is provided in the Command Register to save the 
ER command bit. 



Bit 5, the Request To Se nd Command bit (RTS), sets a 
latch to reflect the RTS signal level. The output of this 
latch is created independently of other signals in the 
COM 8251A. As a result, data transfers may be made by 
the processor to the Transmit Register, and data may be 
actively transmitted to the co mmun ication line through 
TxD regardless of the status of RTS. 

Bit 6, the Internal Reset (IR), causes the COM 8251A to 



return to the Idle mode. All functions within the COM 
8251 A cease and no new operation can be resumed until 
the circuit is reinitialized. If the operating mode is to be 
altered during the execution of a processor program, the 
COM 8251 A must first be reset. Either the RESET input 
can be activated, or the Internal Reset Command can be 
sent to the COM 8251 A. Internal Reset is a momentary 
function performed only when the command is issued. 

Bit 7 is the Enter Hunt command bit (EH). The Enter Hunt 
mode command is only effective for the COM 8251 A when 
it is operating in the Synchronous mode. EH causes the 
receiver to stop assembling characters at the RxD input, 
clear the Rx register to all "ones", and start searching for 
the prescribed sync pattern. Once the "Enter Hunt" mode 
has been initiated, the search for the sync pattern will 
continue indefinitely until EH is reset when a subsequent 
Command Word is sent, when the IR command is sent to 
the COM 8251 A, or when SYNC characters are recognized. 
Parity is not checked in the EH mode. 



STATUS REGISTER 



The Status Register maintains information about the 
current operational status of the COM 8251A. Status can 
be read at any time, however, the status update will be 
inhibited during status read. Figure 6 shows the format of 
the Status Register. 

TxRDY signals the processor that the Transmit Character 
Buffer is empty and that the COM 8251 A can accept a new 
character for transmission. The TxRDY status bit is not 



totally equivalent to the TxRDY output pin, the relationship 
is as follows: 

TxRDY (status bit) = Tx Character Buffer Empty 
TxRDY (pin 15) = Tx Character Buffer Empty • CT5 • TxEN 

RxRDY signals the processor that a completed character 
is holding in the Receive Character Buffer Register for 
transfer to the processor. 



Figure 6. The COM 8251 A Status Register 

7 6 5 4 3 2 1 0-« Bit No. 



n n 



a a n a 



TxRDY 

RxRDY 

TxE 

PE 

Parity error 

OE 
Overrun error 

FE 

Framing error 

SYNDET/BRKDET 
DSR 



TxE signals the processor that the Transmit Register 
is empty. 

PE is the Parity Error signal indicating to the CPU that the 
character stored in the Receive Character Buffer was 
received with an incorrect number of binary "1" bits. PE 
does not inhibit USART operation. PE is reset by the ER bit. 

OE is the receiver Overrun Error. OE is set whenever a byte 
stored in the Receiver Character Register is overwritten 
with a new byte before being transferred to the processor. 
OE does not inhibit USART operation. OE is reset by the 
ER bit. 

FE (Async only) is the character framing error which in- 
dicates that the asynchronous mode byte stored in the 
Receiver Character Buffer was received with incorrect bit 
format ("0" stop bit), as specified by the current mode. FE 
does not inhibit USART operaton. FE is reset by the ER bit. 



SYNDET is the synchronous mode status bit associated 
with internal or external sync detection. 

DSR is the status bit set by the external Data Set Ready 
signal to indicate that the communication Data Set is 
operational. 

All status bits are set by the functions described for 
them. SYNDET is reset whenever the processor reads the 
Status Register. OE, FE, PE are reset by the error reset 
command or the internal reset command or the RESET 
input. OE, FE, or PE being set does not inhibit USART 
operation. 

Many of the bits in the status register arecopies of external 
pins. This dual status arrangement allows the USART to 
be used in both Polled and Interrupt driven environments. 
Status update can have a maximum delay of 16 tcv periods. 



Note: 

1 . While operating the receiver it is important to realize 
that the RxE bit of the Command Instruction only in- 
hibits the assertion of RxRDY; it does not inhibit the 
actual reception of characters. As the receiver is con- 
stantly running, it is possible for it to contain extraneous 
data when it is enabled. To avoid problems this data 
should be read from the USART and discarded. This 
read should be done immediately following the setting 
of the RxE bit in the asynchronous mode, and following 
the setting of EH in the synchronous mode. It is not 
necessary to wait for RxRDY before executing the 
dummy read. 

2. ER should be performed whenever RxE of EH are pro- 
grammed. ER resets all error flags, even if RxE = 0. 



3. The USART may provide faulty RxRDY for the first read 
after power-on or for the first read after the receiver is 
re-enabled by a command instruction (RxE). A dummy 
read is recommended to clear faulty RxRDY. This is not 
the case for the first read after hardware or software 
reset after the device opration has been established. 

4. Internal Sync Detect is disabled when External Sync 
Detect is programmed. An External Sync Detect Status 
is provided through an internal flip-flop which clears 
itself, assuming the External Sync Detect assertion has 
removed, upon a status read. As long as External Sync 
Detect is asserted, External Sync Detect Status will 
remain high. 
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13.1 C0NFIGUR.COM 

This program enables the user to select various operating parame- 
ters for the CompuStar. This feature allows flexibility in your 
CompuStar 's use. The parameters affect the MAIN and AUXILIARY 
ports, the AC line frequency, and disk verification. By allowing 
the user to change these parameters, a variety of peripheral 
devices can be used with your CompuStar VPU. 

The CONFIGUR program is menu-driven; the user selects the parame- 
ter to change, and then follows the instructions listed. To 
initiate the CONFIGUR command, type 'CONFIGUR (cr) 1 at the key- 
board. CONFIGUR will then accept your commands for parameter 
changes. After you are finished, press the return key (you may 
change several of the parameters if you wish); the screen will 
clear, and you will be instructed to press both RED keys on the 
keyboard. This action will force an operating system reload 
containing your new parameters, and these parameters will be 
reloaded each time you reset the operating system. 

Note that the CONFIGUR program will change the copy of the 
operating system located on the diskette in drive A. Even if your 
copy of C0NFIGUR.COM is located on drive B, drive A will be 
affected. A summary of parameter selections is included for 
reference. 



C0NFIGUR.COM SUMMARY 



(A) AC LINE FREQUENCY 

(5) 50 HERTZ 

(6) 60 HERTZ 

(B) DISK READ-AFTER-WRITE VERIFICATION 

(Y) VERIFY DISK WRITE AUTOMATICALLY 

(N) DO NOT VERIFY 

(C) MAIN PORT BAUD RATE 

(A) 9600 

(B) 7200 

(C) 4800 

(D) 3600 

(E) 2400 

(F) 2000 

(G)— -1800 

(H) 1200 

(I) 600 

(j) 300 

(K) 150 

(L) — 134.5 

(M) -110 

(N) 75 

(0) 50 

(D) MAIN PORT CHARACTER LENGTH 

(5) 5 BITS 

(6) 6 BITS 

(7) 7 BITS 

(8) 8 BITS 



(E) MAIN PORT STOP BITS 

(1) 1 STOP BIT 

(2) 1.5 STOP BITS 

(3) 2 STOP BITS 

(F) MAIN PORT PARITY 

(N) NO PARITY 

(E) EVEN PARITY 

(0) ODD PARITY 



(G) AUX PORT BAUD RATE 

(A) 9600 

(B) 7200 

(C) 4800 

(D) 3600 

(E) 2400 

(F) 2000 

(G) 1800 

(H) 1200 

(I) 600 

(j) 300 

(K) 150 

(L) — 134.5 

(M) 110 

(N) 75 

(0) 50 



(H) AUX PORT CHARACTER LENGTH 

(5) 5 BITS 

(6) 6 BITS 

(7) 7 BITS 

(8) 8 BITS 



(I) AUX PORT STOP BITS 

(1) 1 STOP BIT 

(2) 1.5 STOP BITS 

(3) 2 STOP BITS 

(j) AUX PORT PARITY 

(N) NO PARITY 

(E) EVEN PARITY 

(0) ODD PARITY 



(K) AUX PORT HANDSHAKING 

(Y) AUX PORT TRANSMISSION CONTROLLED BY AUX PORT DSR 

(N) AUX PORT TRANSMISSION NOT CONTROLLES BY DSR 



13.2 F0RMAT.COM 

Before diskettes can be used by an Intertec computer, they must 
first be formatted. This process will erase the diskette of all 
data and write certain sector-header information on the diskette 
so that the operating system is able to properly locate data on 
the diskette. F0RMAT.COM is a versatile program that will allow 
the user to format diskettes for both SuperBrain and CompuStar 
computers. 

To load the format program from diskette, type 'FORMAT (cr)' at 
the keyboard. After loading, you should select the type of 
diskette you wish to format. You may select single-sided (for 
SuperBrain and CompuStar Model 20 computers), double-sided (for 
SuperBrain QD and CompuStar Model 30 computers), or double- 
sided/double-tracked (for CompuStar Model 40 diskettes). Once 
your selection has been entered, you will be asked to place an 
unformatted diskette into drive B and type the 'F' key to begin 
formatting. When the formatting is completed, you may continue 
formatting by placing another diskette into drive B and pressing 
the 'F' key. You may repeat this process until all of your 
diskettes have been formatted. Press the 'RETURN 1 key to end the 
formatting session. 

The diskette that you format does not have to be a blank 
diskette. You may* format on old diskette if you wish, but you 
should remember that 'FORMAT 1 will destroy all data on a 
diskette. However, if a the data on a diskette becomes damaged 
(or if you suspect that the data is damaged), copy the diskette 
onto another diskette and reformat the original. This way, you 
save some (or all) of the original data and you don't lose any 
diskettes . 



13.3 64KTEST.COM 

This program performs an extensive test on main memory by writing 
and reading all possible binary patterns to all locations in the 
random access memory (RAM). The process takes between eight and 
ten minutes to complete. 

The test procedure begins by typing '64KTEST (cr) 1 at the key- 
board. After the program is loaded into memory, you will be 
asked to remove all diskettes from their drives. If you have a 
CompuStar Disk Storage System (DSS) connected to the terminal to 
be tested, either power down the DSS or disconnect the DSS from 
the terminal by removing the interconnecting cable. 

Once you have pressed the f G f key to start the test, the screen 
should fill with random text. The patterns on the screen should 
move around. This is because the memory for the screen is also 
undergoing the test. After the test is completed, the screen 
will display f RAM OK', indicating that the test was sucessful. 
The test is an endless loop, and will repeat until the RED keys 
are depressed simultaneously. Therefore, you can test the RAM as 
long as you desire. 

If an error is detected by the test, the test will stop and the 

audible tone will sound continuously. Should this occur, retry 

the test. If the fc tone occurs frequently, please contact the 
Intertec Service Department. 



13.4 TX.COM 

The TX utility is written in standard CP/M assembly language. TX 
is designed to communicate via the computers Main Port with the 
program RX running in the destination machine. Therefore, TX is 
considered the "Master" program, and RX is the "Slave" program. 
RX receives commands from TX such as "Open file", "Read incoming 
data block", "Write block to file", and so on. For this reason, 
the user should only be concerned with console operations for the 
machine in which TX is running. RX receives all directions from 
the communications link. 

Unlike data transfer operations initiated with PIP, the TX/RX 
pair perform block checksum verification, retransmission in the 
event of error, and are insensitive to the type of data being 
transferred. TX/RX may be used to send any type of CP/M file 
without modification, including .COM files. 

TX is initiated by typing the command: *TX (cr) f . The TX program 
will then "sign-on" with an identifying message and version 
number and then give the user an option to proceed or abort. The 
actual console dialogue appears as: 

A>TX 

INTERTEC File Transfer Utility Vers 1.6 

HIT CR WHEN RECEIVE MACHINE READY OR Q TO ABORT 

At this point, start up RX in the destination machine (See RX.COM 
in Section 13.5) 

When a carriage return is entered to TX, it will attempt to 
establish a linkage to the destination RX machine over the compu- 
ter's Main Port. Given that a link can be established, TX will 
display the message: 

LINK TO SLAVE MACHINE ESTABLISHED 

or, if many attempts to link fail: 

UNABLE TO ESTABLISH/MAINTAIN DATA LINK 

(This probably indicates that some aspect of the connection with 
the destination machine is not correct, i.e. inconsistent baud 
rates, improper cabling, or excessive line noise.) 

The TX program then prompts the user to enter both the source 
file name and the destination file name. These names must be 
fully qualified, non-ambigous file references. This includes 
disk specifiers. 



If the specified file already exists on the receiving machine, TX 
will display: 



FILE ALREADY EXISTS ON RECEIVING MACHINE 

and the link is terminated. 

As an expediency, send the file again, but with a temporary 
destination file name. 

As a file is being transmitted under TX/RX, both TX and RX will 
display a record count. This serves to indicate that the data is 
being transferred correctly. It is normal to see a difference of 
one record between the two counts upon completion of a file 
transfer. 

If TX detects a failure in the data link, it will output the 
message: 

UNABLE TO ESTABLISH/MAINTAIN DATA LINK 

When a file has been transmitted, TX displays the message: 

FUNCTION COMPLETE 

TYPE R TO REPEAT, CR TO EXIT 

If another file is to be transferred, enter the letter "R M and TX 
will request another pair of file names. Entry of a carriage 
return will cause TX to command RX to shutdown and both will 
terminate. 

There are two other messages that could be output by TX. 

As each data block is sent, a checksum is calculated and 
transmitted. If RX detects a discrepancy between the received 
checksum and that which has been calculated for the received 
data, it will request that TX re-send the block in question. If 
the block cannot be received correctly after several re-transmis- 
sions, the message: 

HARD DATA TRANSMISSION ERROR 

will be rendered. The most likely cause of this failure is bad 
hardware. 

If the diskette on which RX attempts to place the incoming data 
file is write protected, or if there is not enough space to 
contain the incoming file, TX will display: 

RECEIVE CANNOT CLOSE FILE 



13.5 RX.COM 

RX is an assembly language program designed to receive data files 
transmitted by TX from the computer's Main Port. It operates as 
a slave to the TX program, receiving commands from TX to perform 
operations on the destination machine. 

RX is initiated by typing the command 'RX (cr) '. Upon initiation, 
RX displays a "sign-on" message of the form: 

INTERTEC File Transfer Utility Vers 1.3 

From this point on, unless an error condition occurs, no further 
operator action is required. 

As each data block is received, RX outputs a running count of the 
data blocks received. At the end of each received file, RX 
displays the message: 

END-OF-FILE RECEIVED 

When all files have been received, TX will command RX to 
terminate and RX will display: 

LINK TERMINATED 

If the data link cannot be established or maintained (indicated 
by a message on the TX system) , it will be necessary to reset the 
destination system. This is accomplished on the destination 
computer by depressing both RED keys simultaneously. 



13.6 HEXDUMP.COM 

This is a system utility designed to generate a 'HEX' file from a 
♦COM' file, and transfer the contents out of a desired port. 
Since the PIP program cannot transfer 'COM' files, this utility 
is useful in effecting file transfers with the PIP program. To 
initiate the Hexdump facility, type the following at the key- 
board: 'HEXDUMP (cr)'. The program will be loaded and then await 
your instructions. 

The first thing that the Hexdump procedure requests is the port 
to which you wish to dump the file. Here enter f 1 f for the MAIN 
port (corresponding to CP/M's PUN: and RDR: device), or '2' for 
the AUXILIARY port (corresponding to CP/M's LST: device). You 
must enter either a ' 1 ' or a '2', invalid entries will be 
ignored. Next you may choose whether or not you wish to have the 
'HEX' file echoed to the console (this will display the file as 
transmitted). Enter '1' if you do not wish to have the file 
echoed on the screen, or '2' if you wish to have the contents 
echoed. Again, invalid entries will be ignored. 

Now you are ready to enter the file name. You must enter the 
drive designator, the file name and the file type. Seperate the 
drive indicator from the file name with a colon (':'), and the 
type from the name with a period ('.♦). Press the return key 
after entering the name. 

Example : 

A> HEXDUMP (cr) 

HEXDUMP FILE UTILITY VER. 3.1 

SELECT ONE OF THE FOLLOWING: (TYPE THE NUMBER) 

1 - THE MAIN PORT (PUN:) 

2 - THE AUX PORT (LST:) 
2 

SELECT ECHO ON THE CONSOLE: 

1 - DO NOT ECHO ON THE CONSOLE 

2 - ECHO TO THE CONSOLE 
J_ 

ENTER DISC, FILE-NAME, AND FILE-TYPE TO BE TRANSFERRED. 
A: STAT. COM (cr) 

FILE TRANSFER COMPLETED. 



In the example above, the file STAT.COM was transferee! from disk 
A through the auxiliary port. HEXDUMP.COM will only transfer 
files which exist on drives A and B. If you enter an erroneous 
file-name or disk drive, the program will display an error mes- 
sage. If HEXDUMP.COM is unable to locate the given file, another 
error message will be given. When the transmission has completed, 
the screen will indicate this and return to the operating system. 
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13.7 



SYNCHRONOUS COMMUNICATION 



Your computer system is factory configured to program the Univer- 
sal Synchronous/Asynchronous Receiver/Transmitter (USART) to 
operate in the asynchronous mode. It is possible, however, to 
change this and permit the Bisync, or byte synchronous, communi- 
cation mode. You will be responsible for writing the software 
drivers that send and receive synchronous data through to the 
MAIN port at the rear of your terminal. This section will in- 
struct you to properly program the USART which is the interface 
between the CPU and the main port of your computer. 
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SYNC: 



FALSE 


EQU 





TRUE 


EQU 


NOT FALSE 


SUPER 


EQU 


TRUE 


COMPU 


EQU 


FALSE 


» 


IF 


SUPER 


USCMD 


EQU 


0EF01H 


MODE 






USINS 


EQU 


0EF02H 


INSTRUCTION 




RETPNT 


EQU 


0E5F8H 


POINT 


ENDIF 




> 


IF 


COMPU 


USCMD 


EQU 


0EF01H 


MODE 






USINS 


EQU 


0EF02H 


INSTRUCTION 





; MODE FOR THE SUPERBRAIN 
; CHANGE IF COMPUSTAR 



ADDRESS OF SUPERBRAIN COMMAND 

ADDRESS OF SUPERBRAIN 
ADDRESS FOR BREAK KEY RETURN 



; ADDRESS OF COMPUSTAR COMMAND 
; ADDRESS OF COMPUSTAR 
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RETPNT 


EQU 


0E5FEH ; 


POINT 








ENDIF 




MNDAT 


EQU 


58H 


MNSTAT 


EQU 


59H ; 


RESET 


DB 


50H ; 


SYNCMD 


DB 


OCH ; 


SYNINS 


DB 


17H ; 


SYNC 


DB 


16H ; 


i 


ORG 
DI 


100H ; 




IN 


MNSTAT ; 




IN 


MNDAT 




MVI 


A, RESET ; 




MVI 


A, SYNC ; 




OUT 


MNSTAT ; 




OUT 


MNSTAT ; 




MVI 


A, SYNCMD ; 




OUT 


MMSTAT 




STA 


SYNMOD ; 




MVI 


A, SYNINS ; 




STA 


UNINS 


; BYPASS THE 


NEXT STEP IF YOU WIS 




MVI 


A,0C9H ; 




STA 


RETPNT ; 




EI 






REST 


OF PROGRAM HERE 



ADDRESS FOR BREAK KEY RETURN 



MAIN PORT DATA 

MAIN PORT STATUS 

USART RESET, ERROR FLAG RESET 

SYNC COMMAND MODE - NO PARITY - 8 BI 

SYNC MODE INSTRUCTION 

ASCII SYNC WORD 

TBASE 

DISABLE THE INTERRUPTS 

FLUSH OUT USART BUFFERS 

A CONTAINS USART .RESET 

SYNC WORD 

SENT TO USART 

RESET USART 

A CONTAINS MODE FOR SYNC. COMM. 

SAVE THIS MODE FOR IN CASE OF RESET 
A CONTAINS USART INSTRUCTION 



THIS IS A RETURN INSTRUCTION 
SAVE IN PROPER RETURN POINT 
ENABLE THE INTERRUPTS AGAIN 



The above example will set up the USART for synchronous communi- 
cation, with 1 sync character, and a word length of eight bits. 
By referencing the specification sheet for the 8251, you may 
alternately change the mode word to allow 2 sync characters, a 
different word length, or some other set up. Note that the return 
instruction stored at RETPNT will disable the BREAK key from 
resetting the USART line; clever programming will be needed to 
allow this. 
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13.8 USING THE "INP:" AND "OUT:" FEATURES OF PIP 

TO FACILITATE FILE TRANSFERS TO AND FROM THE COMPUSTAR 



The CompuStar is equipped with a 'MAIN 1 RS-232-C serial interface 
port on the rear panel. This interface should be programmed for 
the following mode: 

Asynchronous 
1200 Baud 
8 bits 
1 Stop Bit 
No Parity 

This port is also wired so that the CompuStar appears as a 

processor rather than as a terminal. If it is to be used as a 

terminal, pins 2 and 3 in the RS-232-C cable must be 
interchanged . 

Files can be transferred using the PIP program as described in 
Section 6.4 of the Operators Manual entitled "An Introduction to 
CP/M Features and Facilities." When the CompuStar transmits 
serial data, the destination is designated as a list (LST:) 
device; when receiving, the source device is considered a reader 
(RDR:). 

The serial port may also be considered as an input (INP:) or 

output (OUT:) port. When used in this mode, the operator has the 

option of communicating to the sending/receiving device via the 
CompuStar console before actual files are transferred. 

Files transferred via the serial port must be in Intel hex format 
or ASCII. Binary files must be converted to hex files by 
utilizing the HEXGEN.ASM program before being sent to the 
CompuStar. BASIC files must be saved in the ASCII format if they 
are to be transferred to the serial interface. 

(NOTE: When ASCII files are transferred using the INP: or OUT: 
format, all data entered by the Operator on the console will also 
appear in the ASCII file. Undesired data must then be edited by 
using ED.COM.) 
Sequence of Operation : 

1 . Connect CompuStar MAIN port to console input of host 
computer. Be sure host computer is set to 1200 baud. 

2. The largest program that can be transferred by PIP is 25K. 
If programs are larger than 25K, then programs must be 
broken down into smaller segments. 

3. All commands must be entered on the CompuStar in the 
following sequence. 

A. To transfer ASCII file - ABC. ASM - from CompuStar to 
host: 
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A> PIP OUT: = ABC. ASM (cr) 
ECHO~TY/N) Y 



(Keyboard entry) 
(Computer responds) 
(Keyboard entry) 
(Computer Responds) 



Now the CompuStar will act like a dumb terminal for host 
computer. Any keyboard entry will be sent to host computer 
and displayed on screen. 



+ HL ABC.HST = CON: (cr) 
(CTRL) (B) 



(Keyboard entry) 

(Computer responds) 
(Keyboard entry - these 

two keys at the same 

time) 



NOTE: Underlined characters are typed by customer, 
"(cr)" represents a carriage return. 

Now the file is being transferred and should be displayed on 
the screen. When the file has been transferred the 
operating system will show the pr'ompt symbol. 



A> PIP OUT: = EOF: (cr) 
ECH5~~ TT7TT)"Y 



(CTRL) (B) 



(Keyboard entry) 

(Computer responds) 
(Keyboard entry) 
(Computer resonds) 
(Keyboard entry - these 
two at the same time) 



Now the file transfer has been completed; both computers 
should return to the operating system. 

B. To transfer binary file - ABC.COM - from CompuStar to host: 
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A> PIP ABC.TST _= 
ECHO CY/N) Y 



INP: (cr) 



(Keyboard entry) 
(Computer responds) 
(Keyboard entry) 
(Computer responds) 



Now the CompuStar will act like a dumb terminal for the 
host computer. Any keyboard entry will be sent to the host 
computer and displayed on the screen. 



+ PIP ABC. HEX = CON: (cr) 



(Keyboard entry) 



NOTE: The binary file on the CompuStar will be transferred 
in INTEL HEX format. After the transfer use LOAD or 
DDT and SAVE to change. HEX file to a binary, COM 
file. 



(CTRL) (Z) 

End of file, Control Z? 
(CTRL) (Z) 



(Keyboard entry - these 
two at the same time) 
(Computer responds) 
(Keyboard entry - these 
two keys) 



Now the host computer is set up to input a file. The 
CompuStar will return to thef operating system with 
its prompt. 



A> HEXDUMP ABC.COM (cr) 



(keyboard entry) 



At this point the file will be transferred in HEX format and 
displayed on thf screen. When the transfer is complete the 
CompuStar will return to the operating system. 

C. To transfer ASCII file - ABC.PRN - to CompuStar from host: 



A> PIP ABC.PRN = INP: (cr) 
fCHO H7N) Y 



(Keyboard entry) 
(Computer responds) 
(Keyboard entry) 
(Computer responds) 



Now the CompuStar is ready for input form host. The 
keyboard entry will be sent to the host and displayed on the 
screen. Now set up commands to output from the host. 



+ PIP CON: = ABC.PRN (cr) 



(Keyboard entry) 



The file ABC.PRN on the host is now being input to the 
CompuStar and displayed on the screen. After the file has 
been transferred, the CompuStar should return to 
operating system; if it does not, then type (CTRL) 
simultaneously. 



the 
(Z) 
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D. To transfer binary fiele - ABC.COM - to CompuStar from 
host : 

(NOTE: Before transferring to CompuStar, either HEXGEN.ASM 
or HEXDUMP.COM must be transferred to the host.) 



1) Using HEXDUMP.COM 

A> PIP ABC. HEX = INP: [H] (cr) 
ECHO (Y/N) Y 



(Keyboard entry) 
(Computer Responds) 
(Keyboard entry) 
(Computer responds 



Now the CompuStar is ready to accept input. NOTE: Since a 
binary file is transferred in INTEL HEX format, the .HEX 
file on thef CompuStar can be changed using LOAD or DDT and 
SAVE, to a binary file. 



+ HEXDUMP ABC.COM (cr) 



(keyboard entry) 



The file is now being transferred and also 
the screen. When the transfer is complete, 
will return to the operating system. 

2) Using HEXGEN.ASM 

Look at source listing: 



ORG 



6000H 



displayed on 
the CompuStar 



LXI 
LXI 
LXI 



SP 6400H 
D, 6000H 
H, 100H 



*ending address 
♦beginning address 



The origin and the SP will need to be modified for your 
particular system. (For example: 32K systems use ORG 
5000H, and SP, 5400H.) You may also change H,D to suit 
program size; register H is loaded with the end adress of 
the program to be transferred, and register D has the 
beginning address (most programs begin at 100H). Now run 
assembler to generate HEXGEN.HEX. You are ready to begin. 



A> PIP ABC. HEX = INP: [H] 
ECHO (T7F5 Y 



(Keyboard entry) 
(Computer responds) 
(Keyboard entry) 
(Computer responds) 



At this point the CompuStar is ready for inputr and the 
host must be set up to output the HEX file. 
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+ DDT (Keyboard entry) 

Version 1.4 (Computer responds) 

Now we have loaded DDT into the host system. 

IABC.COM (cr) (Keyboard entry) 

^R (cr) 

NEXT PC (Computer Responds) 

0A00 0100 (These two numbers are 

the end and starting 
address ) 

-IHEXGEN.HEX (cr) (Keyboard entry) 

zH (cr) 

NEXT PC (Computer responds) 

60B8 0100 

At this point the host computer has 2 programs loaded into 

memory, one above the other. One is the program to be 

transferred, and the other to generate the INTEL HEX 
format . 

-G6000 (cr) (Keyboard entry) 

(The number is the 
same as ORG in the 
source listing) 

Now the file is being transferred and will be displayed on 
the screen. After the program has been transferred, the 
CompuStar will return to the the operating system. 

3) To change back to a binary file , follow this procedure: 

A> LOAD ABC. HEX (cr) (Keyboard entry) 

LAST ADDRESS XXXX (Computer responds) 

FIRST ADDRESS XXXX 
BYTES READ XXXX 
RECORDS WRITTEN XX 

A> 

Now there are two files: one HEX and one binary. 

or 

A> DDT ABC. HEX (cr) (Keyboard entry) 

Version 1.4 (Computer responds) 

Next PC 
ABCD 0100 

(CTRL) (C) (Keyboard entry - bot 

keys at same time) 



17 



A> SAVE XX ABC.COM (cr) (Keyboard entry) 

NOTE: XX = A times 16 + B 
under NEXT 

Now there are two files: one .HEX and one binary 
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VERSION 3.1 DISK OPERATING SYSTEM SOFTWARE RELEASE 

The Disk Operating System on many Intertec computer systems now 

features many enhancements. This new DOS will run on any 

SuperBrain or SuperBrain QD video computer system which is 

in current production. These software changes are designed to 

provide greater operator efficiency, more powerful software, and 

more flexible computer usage. These changes are listed below, and 
a further explanation of their use is described later in this 
document. 



Audible feedback with each key depression (selectable) 

Key repeat after key is held down 

Type-ahead permitting 128 characters to be entered ahead 
of computer 

Time of day maintained by the operating system 

Date kept by the operating system, including end-of-month 
and end-of-year checks 

Synchronous communication capability via the MAIN serial 
I/O port 

Data Set Ready (DSR) can be checked prior to output on 
the MAIN port before transmission to enable 'handshaking' 
( selectable) 

Redefinable Numeric Keypad, allowing any value to be 
assigned to any key on the pad 



Contact the Customer Service Department at the address above for additional information on this hui/etin 
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OPERATION ENHANCEMENTS 



Audible Feedback 



The audible feedback feature is designed to provide a tone with 
each key depression. The purpose of the feedback is to allow 
faster data entry by informing the operator whenever a key is 
depressed. This feature can be easily selected during terminal 
operation or can be automatically selected upon system power-up. 

To enable the feedback feature, simply display a Control-B (02H). 
This will 'toggle* the key click feature and turn it "on if it is 
off, or vice versa. The CONFIGUR program will permit you to set 
the click on or off on system power-up, and hence, relieve you of 
any further action. (See Technical Bulletin concerning CONFIGUR 
operati on . ) 



Key Repeat 

When a key remains depressed for more than 600 milliseconds, the 
key value will repeat at a rate of approximately 30 per second. 
This will allow faster data entry for aplications such as word 
processing, text editing, and program displays where a 'banner' 
is required. 



Type-ahead 

The input on DOS version 3.1 is saved if the operator enters data 
faster than the computer can accept it. Up to 128 characters are 
stored when typed, and delivered only when needed. It is now 
possible to enter commands to an application program as it is 
being loaded from the disk and not lose any characters. Your 
input will appear after the program has been loaded, and the 
program will execute the commands as if you had just entered 
them. If you type more than 128 characters ahead of the computer 
system, the bell will ring. This indicates that the buffer is 
full, and further typing will be ignored by the system. 



Contact the Customer Service Department at the address above for additional information on this bulletin. 
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Notes 

It should be noted that some programs will not work with the 
type-ahead feature. An example is the ' D I R ' command, which dis- 
plays the directory contents of a diskette. By definition, a 
directory display is interrupted if a key is depressed during the 
display. If the ' DI R ' command receives a key from the type-ahead 
feature, it doesn't know if the key was just entered, or if it 
came from the buffer. In either case, the display is disrupted 
and a character is lost. Experiment with the system to see which 
programs will not tolerate type-ahead. 

ADDED CONVENIENCES 

Time 

The Operating System will now keep the time of day. The time is 
maintained in ASCII, and therefore, its contents are displayable 
at any time and no conversion is necessary. The location of the 
time is 42 through 4A Hexadecimal so these locations cannot be 
used by the programmer. The time is kept in military format with 
values ranging from 00:00:00 to 23:59:59. At midnight the time 
resets itself and also changes the value of the date. (See the 
subsection entitled 'Date' for more information.) 

The time may be displayed upon the screen in the upper right 
corner. This feature may be disabled if such a display is not 
desired. By displaying a Control-T (14H), the time display is 
'toggled' either on or off. Also, the display can be made to 
remain on or off upon system pow-er-up via the CONFIGUR program. 
The time is always maintained by the operating system even if the 
the time display is disabled. 

The time may be set with the 'TIME' commands This is a system 
program supplied on the distribution diskette. To set the time 
type 'TIME' followed by the current time. The time must be en- 
tered in military format (hh:mm:ss), and separating colons must 
be supplied. If an invalid number is entered for the time, then 
the operator is'warned, and the time is not set. 



Contact the Customer Service Department at the address above for additional information on this bulletin. 
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Note that when the time display is enabled, it takes precedence 
over anything which may be displayed upon the screen and will 
over-write any characters which would have been displayed on the 
last nine positions of the firstline. It is not possible to use 
these positions for data display if the time display is enabled. 
Note also that this is a 'software clock' and may be inaccurate 
as much as several seconds per day. 



Date 

The Operating System will now keep the date. The date is located 
at locations 4B through 4D Hexadecimal. These locations are now 
reserved and may not be used by the programmer. The date is 
maintained in packed binary-coded decimal, or BCD, format. The 
three bytes storing the date are for the month, day, and year, 
respectively (the year is the last two digits only). At midnight, 
the Operating System will increment the day by one, and then 
check for end of month. If it is the end of the month, the month 
is incremented. The system will also check for the end of the 
year. 

The date may be queried or set with a new command called 'DATE'. 
This is a system program located on the distribution diskette. To 
set the date, type in.'DATE' followed by the new date in the form 
of mm/dd/yy. If you enter an invalid date, you will be warned so 



and the date will not be set. To view the date, 
itself. This will display the current date. 



type in 'DATE' by 



Other Commands 

The suffix '-22', which was appended to system commands on pre- 
vious software releases, has been omitted from all programs on 
version 3.1. This suffix was to distinguish CP/M version 2.2 
programs from CP/M version 1.4 programs. The suffix is no longer 
needed and will be excluded. 



Contact the Customer Service Department at the address above for additional information on this bulletin. 
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INPUT/OUTPUT ENHANCEMENTS 



Synchronous Communication 

The MAIN serial port on the rear of the computer can now be 
programmed for limited synchronous (Bi-Sync) communication. Syn- 
chronous protocol sends the data over the transmission lines at a 
timed rate and does not rely upon start- and end-of-data indica- 
tors. When data is not available for transmission, the universal 
synchronous/asynchronous receiver/transmitter (USART) enters the 
'synchronous idle* mode and transmits a SYNC byte in lieu of 
data. The receiving USART will intercept this and enter the 
'hunt' mode awaiting resumption of data transmission. 

The USARTs must be programmed upon power-up in order that proper 
operating mode and other parameters can be determined. When the 
initial programming command indicates that the operating mode is 
synchronous, the USART next expects a SYNC character that will be 
transmitted when the USART enters synchronous idle mode. The 
value of this SYNC character is stored with the operating system, 
and can be set via the CONFIGUR program. Also, you may specify 
whether one or two SYNC characters should be sent to the USART. 

It is the responsibility of the user to write his own routines to 
initiate Start-of-Header (SOH), Start-of-Text (STX), End-of-Text 
(ETX), and End-Of -Transmi ss ion (EOT) sequences for Bi-Sync 
communication. The support offered by the Operating System is 
only to insure that the USART will be properly programmed upon 
power-up whenever the BREAK key is depressed. Also take care in 
selecting the clock settings on the blue dipswitch located on the 
upper right corner of the processor board. This switch will 
select the TX clock and the RX clock - refer to Technical 
Bulletin #B010009 found elsewhere in the Operator's Manual for 
explicit instructions. 



Contact the Customer Service Department at the address above for additional information on this bulletin. 
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Synchronous communication is complicated to implement, and it is 
advised that the user be well educated on this subject before 
attempting to communicate in synchronous mode. Currently, the 
Operating System performs no check for parity error, framing 
error, or overrun error. You will have to modify the BIOS listing 
supplied on your distribution diskette and merge it into the 
Operating System to include these checks and any re-transmission 
of data as required. Most peripherals use asynchronous communica- 
tion, and you should ensure that your peripheral will permit 
synchronous communication before attempting to program the MAIN 
port . 



Data Set Ready on MAIN Port 

Quite often a peripheral device will signal the host computer 
when it is able to receive a character for processing. This is 
known as handshaking, because the computer and the device are in 
constant communication with each other. The MAIN port will now 
accept the DSR to be checked prior to any transmission of data. 
If the peripheral device is not ready to accept characters, the 
computer will wait until it is. If this check is not desired, it 
can be bypassed. This setting can be selected in the CONFIGUR 
program. 



KEYPAD REPROGRAMMING 

The 18 keys on the numeric keypad can now be reprogrammed to 
return different values other than those shown on the face of the 
key cap. This feature allows the user to assign any value to any 
key and provides greater flexiblilty in using your computer's 
keyboard. Applications using this include word processors, text 
editors, and custom application programs which recognize special 
values as conditional input. By reassigning the key values and 
changing the key caps, the user can configure his system in 
literally hundreds of ways. 



Contact the Customer Service Department at the address above for additional information on this bulletin. 
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Special note is needed concerning the cursor keys on the extreme 
right of the keypad. These keys will position the cursor upon 
input, i.e., when the key is depressed. After the cursor has been 
moved by these keys, the input value is substituted with another 
value, namely, the ASCII value corresponding to the action taken. 
If you change the values of these keys, then input cursor posi- 
tioning will not occur. However, if any key is assigned 81H, 82H, 
83H, or 85H, thenthe cursor will be positioned upon input left, 
right, up, or down, respectively. 

The keys on the keypad can be changed with the CONFIGUR program. 
You may assign any key a value of from OOH to FFH. When 
reassigning the keys, note that the following values have special 
meaning to the input routine in the Operating System: 

17H (Control-W) Turns on/off the computer's ability to 
scroll the video display. If any key is assigned this 
value and that key is depressed, the cursor may 
disappear after the 24th line on the screen. 

80H Begins the BREAK sequence out of the MAIN port. The BRK 
line on the USART will become high for approximately 
250 milliseconds and will interrupt any data 
transmission. The USART is also reset and is sent the 
command word. 

81H Cursor Left. The cursor is moved one position to the 
left, and the value 08H is returned. 

82H Cursor Right. The cursor is moved one position to the 
right, and the' value 06H is returned. 

83H Cursor Up. The cursor is positioned one line up, and 
the value OBH is returned. 

85H Cursor Down. The cursor is positioned one line down, 
and the value OAH is returned. 



Contact the Customer Service Deoartment at the address above for additional information on this bulletin 
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Control Code Chart 

The following is a list of the hexadecimal equivalents of the 
control codes. The CONGIGUR program accepts only hexadecimal 
values when reassigning the keypad, so these are listed as a 
programmer convenience. Use caution when reassigning the values 
on the keypad, and recall that you may enter 'R' to restore the 
pad to its original configuration if you desire. 

Ctrl-A 01H Ctrl-J OAH Ctrl-S 13H 

Ctrl-B 02H Ctrl-K OBH Ctrl-T 14H 

Ctrl-C 03H Ctrl-L OCH Ctrl-U 15H 

Ctrl-D 04H Ctrl-M ODH Ctrl-V 16H 



Ctrl-J 


OAH 


Ctrl-K 


OBH 


Ctrl-L 


OCH 


Ctrl-M 


ODH 


Ctrl-N 


OEH 


Ctrl-0 


OFH 


Ctrl-P 


10H 


Ctrl-Q 


11H 


Ctrl-R 


12H 



Ctrl-E 05H Ctrl-N OEH Ctrl-W 17H 

Ctrl-F 06H Ctrl-0 OFH Ctrl-X 18H 

Ctrl-G 07H Ctrl-P 10H Ctrl-Y 19H 

Ctrl-H 08H Ctrl-Q 11H Ctrl-Z 1AH 

Ctrl-I 09H 



Contact the Customer Service Department at the address above for additional information on this bulletin. 
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INFORMATION CONCERNING C0NFIGUR.COM VERSION 3.2 

The system program CONFIGUR has been changed in order to support 
the new Operating System version 3.1. This new version of 
CONFIGUR performs all of the functions of the previous version. 
However, new functions have been added to enhance operational 
characteristics. This technical bulletin will describe the 
operating of the CONFIGUR utility. Below are listed the new 
features that CONFIGUR will perform. 

Enable/Disable Time Display upon system power-up 

Enable/Disable Key-Depressed Feedback upon system power- 
up 

Enable/Disable DSR check on the MAIN serial port 

Select Synchronous or Asynchronous operating mode for the 
MAIN serial port 

Select Number of SYNC Characters for MAIN port operating 
in Synchronous mode 

Select SYNC Character value for MAIN port operating in 
Synchronous mode 

Reprogram the 18-key numeric keypad for any new values, 
including special cursor-positioning keys 



Contact the Customer Service Department at the address above for additional information on this bulletin. 
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OPERATION 



Operating Frequency 

Your computer system can operate at either 50 or 60 Hertz. You 
may select either frequency. It is important that the correct 
frequency be chosen or the USARTs and the real-time clock will 
not properly operate. 



Disk Write Verification 

You may select to have the Operating System perform disk 
read-back verification after each floppy disk write. This feature 
will 'double-check' the write operation, and attempt an automatic 
retry if the disk write did not occur properly. 



Time Display Enable/Disable 

If you wish for the time of day to be constantly displayed in the 
upper right corner of the screen upon power-up, you may select 
this feature here. Note that the time is always maintained 
internally, even if you choose not to display it. Also note that 
this setting is only for power-up, and you may select/deselect 
the time during operation by displaying a Control-T (14H). 



Key Click Enable/Disable 

You may choose to have the audible feedback feature enabled upon 
system power-up. Whenever the audible feedback is enabled, the 
computer will inform the operator with a slight 'click' at each 
ey depression. Note that this setting is only for system power- 
up, and the key click feature can be changed during operation by 
displaying a Control-B (02H). 



Contact the Customer Service Department at the address above for additional information on this bulletin. 
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Main and Aux Port Operation 

Choosing these selections will permit you to change the operating 
parameters of the MAIN and AUX serial I/O ports located on the 
rear of your computer. The details of this selection are covered 
below including which ports are applicable for a given feature. 



Operating Mode 



(MAIN Port Only) 



The MAIN port operating mode selections are synchronous and 
asynchronous. Be certain that the peripheral with which you are 
communicating is capable of operating in the same mode; they 
cannot be different. Note also that when changing to synchronous 
mode, you may need to change the number of SYNC Characters and 
the SYNC Character value. When changing to the asynchronous mode, 
you may need to change the number of stop bits. 



Baud Rate 



(MAIN and AUX Ports) 



A wide range of baud rates can be selected for the port including 
rates from 9600 baud (approximately 960 characters/second) to 50 
baud (5 characters/second). Select the baud rate needed to 
communicate with your peripheral. 



Number of SYNC Characters 



(MAIN Port Only) 



This selection will affect the number of SYNC Characters sent to 
the USART upon system power-up. Select either one or two. 



Number of Stop Bits 



(MAIN and AUX Ports) 



This selection will choose the number of stop bits sent after 
each character when the port is operating in asynchronous mode. 
Select either 1, 1.5, or 2 stop bits. 



Contact the Customer Service Department at the address above for additional information on this bulletin. 




WTETOC 

DATA 

SYSTEMS 



TECHNICAL BULLETIN 

IDS-912A 



i® Corporate Headquarters: 2300 Broad River Road, Columbia, South Carolina 29210 • 803/798-9100 • TWX: 810-666-21 15 



DATE OF THIS RELEASE M <*y> 1981 PAGE 4 0F 6 .BULLETIN # BQ51030 

assembly name/number _C0NFIGUR.COM VERSION. 3_._2. _._.._ PRnnurT DOS Diskette 

REFERENCE ECO# £051041 DISTRIBUTED TO.— B aCJD., F,6 J APPROVED 



Character Length 



(MAIN and AUX Ports) 



You may select the length of the character to be transmitted and 
received. Many selections are provided to insure compatibility 
with older TTY and Baudot machines. Usually eight bits is the 
standard character length. You may, however, select 5, 6, 7, or 8 
bit character lengths. 



Parity 



(MAJN and AUX Ports) 



You may choose to check parity with each transmission. This will 
provide a limited 'checksum' to help insure that proper 
transmission has occurred. However, if parity is enabled, the 
application program will have to test the USART status register 
for parity error. You may also select Even or Odd parity. If you 
choose to check parity, be certain that the device with which you 
are communicating matches your setting. 



Handshaking 



(MAIN and AUX Ports) 



If you wish to check Data Set Ready prior to each character 
transmission, you should enable this function. This will permit a 
peripheral device to signal the computer whenever it cannot 
receive anymore characters. 



SYNC Character Value 



(MAIN Port Only) 



The SYNC Character is the byte that is sent to the USART after it 
has been programmed for synchronous communication. Generally, 
the ASCII value of 13H (SYN) is used, but any binary value may be 
substituted. Make certain that the SYNC Character value matches 
that of the peripheral device with which you are communicating. 
Enter the hexadecimal number desired. 



Contact the Customer Service Department at the address above for additional information on this bulletin. 
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KEYPAD REPROGRAMMING 

The 18 key numeric keypad on the right side of the keyboard can 
be reprogrammed to any input values desired. You may, for 
example, wish to invert the numeric keys on the pad. They will 
then correspond to 'telephone style' with 1-2-3 on the top row 
and 7-8-9 on the bottom. You may wish to replace the keys with 
control -codes which are accepted by a word processing or text 
editing program. The key cap values could then be changed to 
descriptive messages which are easier to learn and understand. 
Any value from 00H to FFH can now be assigned to the numeric keys 
with version 3.2 of CONFIGUR. 

When this selection is entered, an image of the keypad appears on 
the screen. To change the value of any key, depress the 'TAB' key 
until the cursor is over the key you wish to change. Then press 
the escape (ESC) key to indicate the change needed. The cursor 
will position itself on the last line, and a blinking asterisk 
will replace the cursor on the key being changed. Enter the new 
hexadecimal value for this key. Your input must be valid hex 
numbers between 0-F as invalid numbers will not be accepted. 
Press the 'RETURN' key when you are finished. 

To restore the keypad to its original values press the 'R' key 
instead of the ESC or TAB keys. The screen will be updated 
instantly, and the cursor will be repositioned at the beginning 
of the display. When all changes have been entered, pressing the 
'RETURN' key (instead of the ESC or TAB keys) will return you to 
the main menu of selections. 

Special note is needed concernirig the cursor keys on the extreme 
right of the keypad. These keys will position the cursor upon 
input, i.e., when £he key is depressed. After the cursor has been 
moved by these keys, the input value i s v *subst i tuted with another 
value, namely, the ASCII value corresponding to the action taken. 
If you change the values of these keys, then input cursor 
positioning will not occur. However, if any key is assigned 81H, 
82H, 83H, or 85H, the cursor will be positioned left, right, up, 
or down, respectively. 
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Control Code Chart 

The following is a list of the hexadecimal equivalents of the 
control codes. The CONGIGUR program accepts only hexadecimal 
values when reassigning the keypad, so these are listed as a 
programmer convenience. Use caution when reassigning the values 
on the keypad, and recall that you may enter 'R' to restore the 
pad to its original configuration if you desire. 



Ctrl-J OAH Ctrl-S 13H 

Ctrl-K OBH Ctrl-T 14H 

Ctrl-L OCH Ctrl-U 15H 

Ctrl-M ODH Ctrl-V 16H 

Ctrl-N OEH Ctrl-W 17H 

Ctrl-0 OFH Ctrl-X 18H 

Ctrl-P 10H Ctrl-Y 19H 

Ctrl-Q 11H Ctrl-Z 1AH 

Ctrl-R 12H 



After all corrections have been entered, pressing the 'RETURN' 
key will save your new parameters on the disk. This must be done 
at the main menu of selections. Then press both RED keys when 
instructed to force a 'cold boot' of the Operating System and 
properly load your newly changed parameters. 
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STATEMENT OF LIMITED WARRANTY 

For ninety (90) days from the date of shipment from our manufacturing plant at 2300 Broad River Road, Columbia, South Carolina, Intertec warrants, to 
the original purchaser only, that its products, excluding software products, will be free of defective parts or components and agrees to replace or repair any 
defective component which, in Intertec's judgment, shall disclose to have been originally defective. Intertec neither offers nor implies any warranty 
whatsoever on any software products. Furthermore, Intertec's obligations under this limited warranty are subject to the following conditions: 

LIMITED WARRANTY REPAIRS 

Unless authorized by written statement from Intertec, all repairs must be done by Intertec at our plant in Columbia, South Carolina. Return of any and all 
parts and/or equipment must be freight prepaid and accompanied by an Intertec Return Material Authorization number which must be clearly visible on the 
customer's shipping label. Return of parts or equipment contrary to this policy shall result in the material being refused, and the customer being invoiced 
for any replacement parts, if any were previously issued, at Intertec's standard prices. 

When making repairs or replacing parts in accordance with this limited warranty, Intertec reserves the right to alter and/or modify specifications of this 
equipment. 

Upon completion of the repairs, Intertec will return the equipment, freight collect, directly to the customer from whom it was sent via UPS or equivalent 
ground transportation. 

Authorization to return equipment for repair can be obtained by writing Intertec at the address stated herein or by calling our Customer Service 
Department at 803/798-9100. 

In the event Intertec shall authorize repair of its equipment, in writing, by-an authorized repair agent, then Customer shall bear all shipping, packing, 
inspection and insurance costs necessary to effectuate repairs under this warranty. 

EXCLUSIONS 

The Limited Warranty provided by Intertec Data Systems Corporation does not include: 

(a) Any damage or defect caused by injuries received in shipment or any damage caused by unauthorized repairs or adjustments. The risk of loss or 
damage to the equipment shall pass to the Customer upon delivery by Intertec to the carrier at Intertec's premises. 

(b) Repair, damage or increase in service time caused by failure to continually provide a suitable installation environment including, but not limited to, 
the failure to provide, or the failure of, adequate electrical power, air-conditioning, or humidity control. 

(c) Repair, damage or increase in service time caused by accident or disaster, which shall include, but not be limited to, fire, flood, water, wind, lightning, 
transportation neglect, misuse and alterations, which shall include, but not be limited to, any deviation from the original physical, mechanical or electrical 
design of the product. 

(d) Any statements made about the equipment by salesman, dealers or agents unless such statements are in a written document signed by an officer of 
Intertec Data Systems Corporation. Such statements do not constitute warranties, shall not be relied on by the buyer, and are not part of the contract for 
sale. 

(e) Any damage arising out of any application for its products other than for normal commercial and industrial use, unless such application is, upon 
request, specifically approved in writing by Intertec. Intertec products are sophisticated data processing units and are not sold or distributed for personal, 
family or household purposes. 

This Class A equipment generates, uses, and can radiate radio frequency energy and if not installed and used in accordance with the instructions 
manual, may cause interference to radio communications. As temporarily permitted by regulation it has not been tested for compliance with the limits for 
Class A computing devices pursuant to Subpart I of Part 1 5 of FCC Rules, which are designed to provide reasonable protection against such interference. 
Operation of this equipment in a residential area is likely to cause interference in which case the user at his own expense will be required to take whatever 
measures may be required to correct the interference. 

(f) Software, including either source code, object code or any computer program used in connection with our equipment, whether purchased directly 
from Intertec or from an independent source. 

WAIVER OF ALL EXPRESS OR IMPLIED WARRANTIES 

Our limited warranty to repair or replace defective parts or components for ninety (90) days after shipment from our Columbia plant is being offered in 
lieu of all express or implied warranties. 

INTERTEC MAKES NO EXPRESS WARRANTY OTHER THAN THE LIMITED WARRANTY SET FORTH ABOVE, CONCERNING THIS PRODUCT OR ITS 
COMPONENTS, NOR DO WE IMPLIEDLY WARRANT ITS MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. 

All statements, technical information and recommendations contained in this and related documents are based on tests we believe to be reliable, but the 
accuracy or completeness thereof is not guaranteed. 

THE FOREGOING LIMITED WARRANTIES ARE IN LIEU OF ALL OTHER WARRANTIES, EXPRESS OR IMPLIED, EXCEPT AS TO CONSUMER GOODS IN 
WHICH CASE THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE APPLY ONLY FOR THE PERIOD OF 
THE LIMITED WARRANTY. 

PURCHASERS OF CONSUMER PRODUCTS SHOULD NOTE THAT SOME STATES DO NOT ALLOW FOR THE EXCLUSION OF CONSEQUENTIAL 
DAMAGES OR THE LIMITATION OR THE DURATION OF IMPLIED WARRANTIES SO THE ABOVE EXCLUSION AND LIMITATION MAY NOT BE 
APPLICABLE. 

THIS LIMITED WARRANTY GIVES THE PURCHASER SPECIFIC LEGAL RIGHTS, AND THE PURCHASER MAY ALSO HAVE OTHER RIGHTS WHICH 
MAY VARY FROM STATE TO STATE. 

LIMITATION OF REMEDIES 

INTERTEC SHALL NOT BE LIABLE FOR ANY INJURY, LOSS OR DAMAGE, DIRECT OR CONSEQUENTIAL, TO PERSONS OR PROPERTY CAUSED 
EITHER DIRECTLY OR INDIRECTLY BY THE USE OR INABILITY TO USE ITS PRODUCTS AND/OR DOCUMENTS. SUCH LIMITATION IN LIABILITY SHALL 
REMAIN IN FULL FORCE AND EFFECT EVEN WHEN INTERTEC MAY HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH INJURIES, LOSSES OR 
DAMAGES. 

Before purchasing or using, the Customer shall determine the suitability of Intertec's products and documents for his intended use and assumes all risk 
and liability whatsoever in connection therewith. 

THE LIMITED WARRANTY TO REPLACE OR REPAIR PARTS OR COMPONENTS FOR NINETY (90) DAYS IS THE EXCLUSIVE REMEDY PROVIDED TO 
THE CUSTOMER AND THE LIABILITY OF INTERTEC WITH RESPECT TO ANY OTHER CONTRACT, SALE OR ANYTHING DONE IN CONNECTION 
THEREWITH, WHETHER IN CONTRACT, IN TORT, UNDER ANY WARRANTY, OR OTHERWISE, SHALL NOT EXCEED THE PRICE OF THE PART OR 
COMPONENT ON WHICH SUCH LIABILITY IS BASED. 

Rights under this warranty are not assignable without the express prior consent, in writing, of Intertec Data Systems Corporation, and, regarding the 
terms of such consent in writing, the assignee shall have no greater rights than his assignor. 

In the event the Customer has any problem or complaints arising out of any breach of our limited warranty, including a failure to make repairs in 
accordance with the warranty, or unsuccessful repair attempts by an authorized repair facility, the Customer is encouraged to inform Intertec, in writing, of 
his or her problem or complaint. Any such writing should be addressed to Intertec Data Systems Corporation, 2300 Broad River Road, Columbia, South 
Carolina 29210, and should be marked with the phrase "Warranty Claim." 



